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WELCOME TO 


THE OFFICIAL 


PI MAGAZINE! 


indows is synonymous with computers. 
After decades of it being the most 
popular operating system in the 
home, it’s been interesting to see Microsoft 
experimenting with expanding the uses of 
Windows. Recently, the firm got behind the 
maker movement, which led to Windows 10 
being ported to the Raspberry Pi last year, in 
the form of Windows 10 IoT Core. There’s been 
a great reaction from the maker community, 
and it’s currently included on NOOBS for 
everyone to use. 
Now with the Raspberry Pi 3 out, Windows 
10 IoT Core has much more power to play with 
and the team at Microsoft are keen to show 
off what it can do. They’ve even made a new 
kit full of great project parts so you can make 
the most out of Windows 10 on Raspberry Pi. 
To celebrate this, we’ve got a whole feature on 
Windows 10 IoT Core - starting on page 14 ~- 
that shows you what’s in the new kit, some of 
the amazing things you can do with IoT Core 
on Raspberry Pi, and some quick lessons to get 
started making with Windows. 

We hope you enjoy the issue! 


Rob Zwetsloot 
Features Editor 
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ONE GIANT LEAP 


Young coders in Australia were asked to aim for the moon 
in a world record attempt 


Children 

aimed for the moon 
in their bid to seta 
world coding record 


Abou! 


sx | 


egardless of the pursuit, 

there are few more exciting 

things in life than an 
attempt at a world record. Whether 
yow re trying to grow an extra 
centimetre of fingernail in order to 
beat Shridar Chillai (how he types 
is anyone’s guess), or whether 
you’re looking to break the most 
toilet seats using only your head 
(46, as it stands), the will to be the 
best can take some dedication. 

Code Club Australia (CCA) knows 

that more than most. On 20 July, 
the club’s organisers looked to 
encourage 10,000 kids to take part in 
Moonhack, an online programming 
workshop that asked children to 
choose a moon-themed coding 
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activity using Python, Scratch, or 
a combination of HTML and CSS. 
In doing so, it sought to set a world 
record for the largest number of 
children coding at the same time. 
Much to the delight of CCA 
general manager Kelly Tagalan, 
children rose to the challenge, just 
as Annie Parker did in 2014 when 
she set up Code Club Australia 
for the benefit of 9 to 11-year- 
olds and watched its presence 
extend to 1,000 schools. “We had 
over 1,000 kids straight after the 
announcement,” says Tagalan, who 
came up with the idea for setting a 
world record as a way of achieving 
something big with a simple 
concept. “Principals, teachers, and 


parents demonstrated a real zeal for 
what we were hoping to achieve.” 


An important anniversary 
But it wasn’t easy. Working with 
CCA board member Clive Dickens, 
the first task was to connect the 
idea to a purpose. “We discovered 
that the anniversary of the Apollo 11 
moon landing was 20 July,” Tagalan 
recalls. She added that it was a 
perfect tie-in: due to the position 
of the earth when Neil Armstrong 
walked on the lunar surface, the 
Parkes Dish in New South Wales 
received the first images of the 

US astronaut and put them out for 
the world. “It was live-streaming 
long before YouTube, and [with 


It was rather apt for Moonhack 

to take place in Australia on 

the anniversary of the Apollo 11 
moon landing. “It was through the 
antenna dish now at this complex 
lin Canberra] that the historic 
images of Neil Armstrong stepping 
onto the surface of the moon were 
received and relayed to the entire 
world,” Nagle explains. 
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Above The Code Club Australia website 
- codeclubau.org - had a dedicated 
Moonhack section 


Moonhack] we were hoping to 
make a connection for Australian 
kids to a very important moment in 
world history that had a significant 
Australian contribution,” she says. 
It was a wise choice. The space- 
based theme and CCA’s giant leap of 
ambition (10,000 children represents 
a quarter of so of the 45,000 
Australian kids engaged in Code 
Clubs) soon brought high-profile 
backing, not least from the Canberra 
Deep Space Communication 
Complex (CDSCC), which maintains 
one of three stations in the Deep 
Space Network on behalf of NASA. 
Glen Nagle, the NASA operations 
support officer for the CDSCC, 
contacted the organisers to discuss 
ways of supporting the activity. 
“When Glen reached out to us, 
we were — pardon the pun ~- over 
the moon,” Tagalan says. “We 
were really grateful that the 
announcement had reached that far, 
and pleased to have had his expertise 
on the history of the moon landing. 
It’s a wonderful thing to have such 
a great organisation stand behind 
getting kids ready for fantastic 
futures through education.” 


Aim for the moon 

For the CDSCC, Moonhack 
presented a golden opportunity. 
Its deep space tracking station has 
its own education program which 
encourages more than 10,000 
students each year to pursue 

the STEM subjects, and seeks to 
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ONE GIANT LEAP FOR CODING 


MOONHACK 


20" JULY 2016 


Right Posters could be printed and 
distributed, to drum up greater numbers 
of children 


promote science and technology 
education to the next generation of 
space explorers. “The Moonhack 
program certainly fitted into our 
theme of promoting space science 
to schoolchildren, and showing how 
they don’t have to wait years to get 
a degree to become a Scientist or 
engineer,” Nagle explains. 

As such, the CDSCC worked with 
Moonhack to make more teachers 
aware of the event and encourage 
them to introduce it into their 
schools. “We included messages 
about Moonhack in our teachers’ 
kits and spread the message through 
our social media channels,” Nagle 
continues. To encourage them 
further, some of the best students 
from Moonhack are being invited 
to take a look behind the scenes at 
Australia’s role in space exploration 
at the CDSCC. “Tt was really 
wonderful to have the invitation 
to visit the NASA CDSCC centre 
extended to some Code Club kids,” 
says Tagalan. 

It’s certainly been a good year 
for tying coding to all things space. 
Astro Pi, which was taken on board 
the International Space Station 
and used by British astronaut Tim 
Peake, attracted lots of attention. 
“Having students being able to 
run experiments on the ISS is 
a brilliant way to engage and 
excite them,” Nagle comments. 
“Australia is participating in 
these sorts of activities through 
the Quberider programme, which 
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Or 


RINGING THE CHANGES 


Last December, 

Code Club Australia 

benefited from a cash 

injection of a million 

Australian dollars from 

the government and 

the Telstra Foundation, 

the philanthropic 

arm of the 

telecommunications 

giant. The Code Club and Telstra are intrinsically 
linked, though, since its founder Annie Parker 
worked for the Foundation’s startup incubator 
programme, muru-D. Telstra chairman Catherine 
Livingstone (pictured) backs the club, saying: “So 
many of tomorrow's jobs are going to require some 
level of knowledge about computer coding.” 


will see students coding small 
instrumentation packages to perform 
experiments remotely on ISS.” 

Such activity, he says, allows for 
a fresh approach to the promotion 
of coding. “Allowing students to do 
more than just the theory of science, 
and actually having them build and 
operate instruments of their own 
design in space, can only capture 
their imaginations and perhaps steer 
them on a path to future careers in 
this area. The only limit to what these 
children can do is their imagination.” 
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TWITCH- 
CONTROLLED 


What happens when you take the concept of Twitch Plays Pokémon 
and transpose it to stream-controlled robots doing arts and crafts? 


witch has long since “Let’s Robot began as an attempt The robot parses the commands and 
stopped just being a place to make the world’s first live- then passes the instructions to the 
to watch people play interactive online show, by using microcontroller on board. We use a 
games. Twitch Plays Pokémon robots,” Jillian Ogle, founder and lot of Arduino-type controllers for 
had the audience play Pokémon CEO of Let’s Robot, tells us. “At the the actual control of the robot.” 
games. Bob Ross spent eleven days time I started this, I was an indie The robots have got up to a lot of 
straight painting happy little trees game developer and used to work mischief in their time on Twitch. 
to launch the creative channel. for big companies like Disney. There have been story-based 
Now, you can control robots live “The way it works is the robot adventures through cardboard 
via the chat with Let’s Robot. streams a live video feed to a web dungeons, harrowing pizza 
page (letsrobot.tv), where the deliveries, artistic competitions, 
audience can see the video and use and even the robots feeding a man 


achat room to talk to each other random items of food set out ona 
and send the robot commands. table for the robots to grab. 


Like a lot of Twitch-controlled projects, simply 
writing keywords in the chat causes the robot to 


perform various actions. The most basic commands 
are for movement: 


forward, back, left, right 


However, you can also control the LEDs on a robot 
using commands such as: 


LED All (Colour); for example, LED All Blue 


LED (Number) (Colour); for example, LED 7 Blue 


You can also give them RGB numbers for colour. 


We understand that Easter eggs have been 


programmed into individual robots as well, so look roS ; = P ESN A The outdoor robot is much more 
. ; $ X robust than the others, with a few 


for more interesting ways to control them. Mars Rover-like features to aid it 
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These robots are incredible artists, putting 
the likes of Jackson Pollock to shame 


Mix in the Raspberry Pi 
As well as Arduinos, the robots 
use a lot of Raspberry Pis, as Jillian 
explains to us: 
“The Raspberry Pi is the most 
consistent component we have 
in all of our robots. It’s used to 
capture and upload video in real- 
time using the camera. It also acts 


wheels, and lights as well as the 
Twitch control aspect. They’re 
mostly small so it’s easier to make 
stuff for them, some have grippers 
and there’s even one with a sword. 
For outdoor incursions, there’s 
also a Mars Rover-esque machine. 
There’s much more to come, 
though, with new robots being 


The robots have a few things 
in common, they all have 
cameras, wheels, and lights 


as a messenger between our web 
server and microcontrollers. 

“We've actually tested a lot of 
boards besides the Pi that are much 
more powerful; however, none of 
them really have the supporting 
tools, hardware, or online support 
and community that makes the 
Raspberry Pi so easy to work with. 
We also like the Pi a lot, because we 
would actually love for people to be 
able to make robots like ours and 
join in the fun.” 

The robots have a few things in 
common; they all have cameras, 
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built all the time and future plans 
in place for robots after that. 

“We have many plans,” Jillian 
mentions. “We’re working to 
make a custom interface that’s 
actually designed for many users to 
collaborate or compete for control of 
a single robot. We’re trying to make 
the audience participation more fun 
and engaging, and working on ways 
to lower the latency.” 

It’s all very exciting, and the 
cake baking challenge for the 
robots is coming up soon as well. 
We’re sure it will be a masterpiece. 


Catch up on some of the robot's best 
adventures so far... 


Feed the human 

Poor intern Carl was used as a prop in a recent stream, 

tasking the chat to feed him via the robots. Apparently, 
they weren't so good at the task, as shown by the mess 
made around Carl's hole in the table. 


Party time 

To celebrate the one-year birthday of Aylobot, the 
robots decided to hold a party. This started with the 
robots writing out invitations, with one robot writing the 
address and another putting the stamps on the letters to 
send them out. They weren't very legible, unfortunately. 


Cup-flipping robot 

This adorable little robot has one function and one 
function only: to grab and flip a cup. Or anything that 
can be grabbed from the sides and thrown into the air. 
It's a tough job, but some robot's got to do it. 
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FARNELL SOLD 


PI PARI NER 
PREMIER 
FARNELL SOLD 


A licensed Raspberry Pi manufacturer is acquired by Swiss firm Datwyler 


hile some misleading to a statement from Datwyler, 
newspaper headlines “Premier Farnell and Datwyler are COMBINED FORCE 
stated that the maker of two leading distributors of electronic 3 R 
: f Assuming the takeover - which 
Raspberry Pis had been sold, there components, with complementary : ; 
: À : is scheduled to close in the 
s no need for concern! The reality product ranges and geographic 
: Nae ; jj fourth quarter - goes ahead as 
s that Premier Farnell, which market presence. E E 
ae : . l i u 
manufactures and distributes Pis While Raspberry Pi sales have P ; Kae 
. ; : : will boast a workforce of over 
under licence from the Raspberry been booming, with 500,000 Pi 3s É ; 
; : : ; : p 10,000. Based in Switzerland, 
Pi Foundation, is the subject of a sold in the new model’s launch r alee 
2 x r W u 
takeover bid by Swiss conglomerate month alone, the Premier Farnell y P y 
x : i comprises more than 50 
Dätwyler. With a recommended business as a whole has been ; ‘ à 
: z n operating companies, with sales 
all-cash offer of 165p per share, struggling with weak sales, resulting P E E ee IE 
A F : EIA á F l V u les, I 
this values the Leeds-based firm, in a dividend cut and decline in g g 
ar ; 3 an annual revenue of around 
which includes the Element14 the share price until the offer was 
; CH1,200m (£947m). Its two 
group, at £792m. According announced on 14 June. RA A PES, : 
; ; main divisions are Technical 
Premier Farnell is one of the 


; ; Components (electronics, 
two key licensed Raspberry Pi P ; 


manufacturers, along with RS 
Components. “We license the 
technical designs for the Pi and 
the various trademarks to the 
partners, who then decide how 
many to make,” explains Raspberry team at Dätwyler and it’s clear they 
Pi Trading CEO Eben Upton. “They understand the value of Pi to the 


automation, and ICT) and 
Sealing Solutions (healthcare, 
civil engineering, automotive, 


and consumer goods). 


are required to keep the product combined business.” 
in stock, and to keep the price Indeed, Eben hopes the 
PI FACTORY at or below an agreed maximum acquisition may have some benefits, 
($35 in the case of the Model 3B), possibly helping to increase Pi sales 
Most Raspberry Pi production, including 100% of but beyond that the practical in other parts of Europe: “Datwyler 
Pi Zeros, occurs at the Sony factory in Pencoed, decision-making is up to them.” have strengths in B2C sales in 
South Wales. Manufacture of all Pi models apart Eben doesn’t believe Raspberry Pi some areas where the licensees 
from the Zero is handled by two main licensed production will be affected: “We’ve have traditionally only had B2B 
partners, Premier Farnell and RS Components, had a fantastic relationship with channels. There is one Datwyler 
who decide how many should be made to meet Premier Farnell over the last four business [Reichelt Elektronik] which 
demand. Official Raspberry Pi add-ons, including and a bit years, and my expectation is already a significant Raspberry Pi 
the Sense HAT and Camera Module, are also made is that the acquisition won’t do reseller, and I hope bringing the two 
at the Pencoed factory. anything to change that. I’ve businesses under the same umbrella 
already had some contact with the will provide a boost.” 
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AWARD-WINNING 
ASTHMA PI KIT 


Nine-year-old Arnav Sharma’s 
Pi-powered asthma management 


kit bags two awards 


rnav Sharma’s AsthmaPi kit 

(youtu.be/3Dniuy4-D3M) 

has won two Tech4Good 
2016 awards: People’s and Winner of 
Winners. Based around a Raspberry 
Pi and Sense HAT, the kit can 
help parents of children suffering 
from asthma. Upon learning that 
asthma attacks can be triggered by 
dust, pollen, pollutants, and other 
environmental factors, keen coder 
Arnav set about researching the 
possibility of creating a detection 
device based on the Raspberry Pi. 
It took him two months to build a 
prototype that monitors all the main 
asthma triggers. 


WITH TSB 
l SHIELD 


The Sense HAT on the Pi measures 
humidity and temperature. A gas 
sensor, wired up to an MCP3008 ADC 
converter on a breadboard, monitors 
hazardous atmospheric gases: 
ammonia, carbon monoxide, and 
CO,. Finally, a dust sensor connected 
via an Arduino Uno detects particles 
and pollen in the air. 

Arnav programmed the kit using 
Python and C++. “Coding was easier 
for the Sense HAT, but was very 
difficult for other sensors.” As well 
as monitoring asthma triggers, the 
kit can even send email and SMS 
text alerts to prompt users to take 
their medication. Arnav has also 


BUILD RASPBERRY PI POWERED ROBOTS 


ASTHMA PI KIT 


tach 4 
3500 

2016 Awards 
TECH4GO0D AWARDS 


Held annually since 2011, the Tech4Good awards 
(tech4goodawards.com) recognise organisations and 


individuals who use digital technology to improve the 
lives of others. Previous winners include the Raspberry 
Pi itself. A finalist for the BT Young Pioneer Award, 
Arnav's AsthmaPi kit picked up the People's Award in 

a public vote of over 38,000 people. It also took home 
the Winner of Winners Award, decided by an audience 


vote at the ceremony, using glow sticks! 


created an accompanying booklet to 
make understanding asthma simple. 
“I would love to produce a 
commercial version of the device,” 
Arnav tells us. The Asthma UK 
charity has already shown an 
interest in the kit, so who knows? 


MOTOR 


when you pre-order 
before 19th August! 


ENTER TO WIN 


THE INTERNET OF 
VOICE CHALLENGE 


Think you got what it takes? Make the best project using 
Amazon Alexa and Raspberry Pi and win Amazon Echos, 
Amazon Taps, Echo Dots, and $11,000 worth of gift cards! 

Contest ends August 31, 2016. 


Go to bit.ly/Alexa-Pi for more details. 


Only on @ hackster.io 
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WINDOWS 1 


IoT CORE 


The Raspberry Pi 3 opens up Windows 10 IoT Core to greater uses 


- here’s how to get started with it... 
t the launch of the 
Raspberry Pi 3 in London, 


A] the Microsoft team were 


present to show off a new project 
they’d created to make use of the 

Pi and Windows 10. On the face of 
it, demonstrating how a feedback 
loop could be created to keep a 
wheel spinning at roughly the same 
speed, even with varying resistance, 
may not seem amazing, but a lot 
was going on to keep it turning. 
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This is the strength of 
Windows 10 IoT Core on the 
Raspberry Pi 3, allowing for more 
power to make unique projects 
that connect to the Internet of 
Things. With a new kit on the way 
to help people get started with 
Windows 10 on Raspberry Pi 3, we 
thought we’d give you a head start 
so you can begin making more 
amazing and varied projects on your 
Raspberry Pi. 
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WINDOWS 


How Microsoft is keen to support the makers of the future with Windows 10 IoT Core 


icrosoft is launching a 

new kit for the Raspberry 

Pi that allows you to 
make some amazing projects with 
Windows 10 IoT Core. We caught 
up with Asobo Mongwa and Dan 
Rosenstein from the Microsoft 
team behind the kit, to find out 
how we got here. 


The MagPi: 


Dan Rosenstein: Raspberry Pi was 
taking off in the market and at 
the same time we were working 
on Windows 10 IoT Core. Since 

the very beginning, our belief has 


been that makers are the creation 
engine and game changer for IoT, 
and that the maker movement 
was going to be the catalyst for 
that change. Our design goal for 
Windows 10 IoT Core was to make 
the programming model easy and 
accessible to makers, and work 
with the large set of democratised 
hardware already in the maker 
ecosystem. Our goal was to join 
makers where they were. The 
Raspberry Pi Foundation provided 
the perfect mix to help launch 
Windows 10 IoT Core: it offered 
the hardware, market share, 
partnership, and community that 
we wanted to be part of. 


WHAT'S IN THE BOX 


The new kit has a wealth of great 
components to get you started 
doing some amazing things with 
Windows 10 loT Core: 


>5-inch display 


> Grove shield (to plug 
components into) 


> Ultrasonic range finder 
> Sound sensor 


> Temperature and humidity 


sensor 
> Light sensor 
> Rotary angle sensor 
> LCD RGB backlight 
> LED bar 
Microsoft was at the > Relay 
Raspberry Pi 3 launch 
to show off its brand 
new wheel project. > Button 
Find out the inner 
workings of it here: > Buzzer 
magpi.cc/2a8rak9 
> HDMI cable 
ma aS 
The new 
Microsoft S 
Grove kit is s 
a specially M l G ro 
put together 
package G rove 
that lets “yy wind 
you make F 
the most of 
Windows 10 
loT Core on 
Raspberry Pi 
3 microsoft 


Asobo Mongwa: 
We’re pleased to see 
the excitement among 
the maker community, 
as more and more 
become familiar with 
the investment Microsoft 
is making in IoT, and the 
continuous improvements 
we’re bringing to Windows 
10 on the Raspberry Pi. We’ve 
heard this excitement first-hand 
during the recent Maker Faires 
in the Bay Area and Washington 
DC. We can’t wait to see how 
makers continue to create new 
innovations using Windows 
10 IoT Core and the Pi 2 and 3, 
particularly now that we’ve shared 
information on our Maker To 
Market pathways: solutions we’ve 
put in place to enable makers to 
accelerate the commercialisation 
of their idea in the Marketplace. 


TM: 


AM: The upcoming Microsoft 
Grove Kit is in collaboration with 
Seeed Studio. Seeed Studio took 
great interest in Microsoft’s 
investments in the IoT and maker 
space, and approached us for a 
co-engineering engagement on 


the kit. We see it as an indicator 
that influencers in the industry 
recognise the impact in the work 
we’re doing, and want to partner 
with us in helping the ecosystem 
to release the next generation 

of solutions on the Raspberry 

Pi with Windows 10 IoT Core. 
The Grove Kit is an enabler, and 
it’s designed for hardware and 
software developers at all levels 
of technical expertise. What I 
personally like about it is the fact 
that it takes away complexities 
like soldering, jumper cables, 
and breadboards, and allows the 
user to focus on their creativity. 
It’s modular, so you can use the 
components included in this 

kit as well as other additional 
Grove components. 


TM: 


DR: There were a few fundamental 
changes with the Pi 3, all of which 
we enabled on Windows 10 IoT 
core: faster clock speed, upgraded 
SD controller, on-board WiFi, 

and on-board Bluetooth. Because 
of the faster clock speed, GPIO 
performance with our Lightning 
driver was measured at a 

higher throughput. 


MEET THE TEAM 


Dan Rosenstein (left) is a Principal 
Technical Program Manager 

and Asobo Mongwa (right) is a 
Program Manager; they both work 
at Microsoft's Operating System 
Group in the Internet of Things 
Maker Program Management 
team. Here they are at the 
National Maker Faire in DC in 
June, one of many maker events 
that the team attend to show 

off the power of Windows 10 

loT Core on Raspberry Pi to the 
maker community. 


TM: 


AM: Raspberry Pi has had a 
significant impact in education 
and the maker movement. We’re 
excited to see the increased 
interest in the industrial market 
for designing end products. We 
partnered with Element14 to 
offer Pi 3 as one of Microsoft’ s 
supported silicon platforms for 
commercialisation with Windows 
10 IoT Core. The Raspberry Pi 

has been showcased at some of 
Microsoft’s major conferences 
like //build, and the Windows 
Hardware Engineering 
Community conference 
in China. These are 
events where we share 
Microsoft’s current and 
future engineering 
investments with 
software and 

hardware 

partners. 


August 2016 


17 


CHROMOTHERAPY 


This futuristic project uses Windows 10 IoT on a Raspberry Pi to monitor your 
happiness. It then adjusts the lighting in a room to match your mood 


You'll 
Need 


» Arduino Uno 
arduino.cc 


> Strip LED RGB 
adafruit.com/ 
product/306 


> Bluetooth HC-05 


> Generic 
breadboard 
uk.farnell.com/ 
prototyping- 
boards 

> Webcam 


uk.farnell.com/ 
webcams 


icrosoft has anew 
service that works with 
facial recognition,” 


explains .NET developer Davide 
Longo. “It processes and returns 
information in the form ofa 
score, rating happiness, anger, 
contempt, disgust, fear, surprise, 
and sadness. 

The service, part of Microsoft's 
Cognitive Services called ‘Emotion 
API’, inspired Davide to build 
this remarkable Windows 10 IoT 
project. Chromotherapy monitors 
a user’s facial expressions and 
adjusts mood lighting to match. 
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The project has a Raspberry Pi 
running Windows IoT 10 Core at its 
heart. The Raspberry Pi is hooked up 
to a webcam, which sends captured 
images of the user’s face to the 
Emotion API. 

This sends a message via 
Bluetooth to the in-home lighting 
system, simulated using an Arduino 
hooked up to an RGB LED strip. 

“Each time I start a new project, 

I try to create something new 

and innovative that uses the 

latest technologies,” says Davide. 
“I immediately thought of the 
importance of light in a workplace. 


“In chromotherapy, there 
are simple colour rules that are 
reflected in daily experience,” 
he explains, “Blue is a calming 
and refreshing colour; green 
symbolises balance, peace, 
and renewal.” 

All code is written in C# 
and available on GitHub 
(magpi.cc/2a31fLp). “Sharing 
ideas is the cradle of future 
innovation,” says Davide. 
“Despite what you might think, 
all the Microsoft programs and 
Microsoft Azure services used 
here are free.” 
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PERSONAL 
HOME SAFETY 


AGEN | 


> Water valve 
magpi.cc/ 
2a3uP2B 


» Water sensor 
magpi.cc/ 
2a3v1io 


> Fire bell 
magpi.cc/ 


2a3ukpg 


> SSR relay 
magpi.cc/ 
2a3uZXY 


> Smoke alarm 
relay module 
magpi.cc/ 
2a3v79J 


> 12V SPDT relay 
(duo and single) 
magpi.cc/ 
2a3vlxR 


anada is a lovely place to 
live, but it’s a challenging 
environment. In winter, 


the temperature can go down to 
-30C, which means heating has 
to be kept on and frozen pipes 
can burst. 

“I was talking to a friend,” says 
Philippe Libioulle. “He had to live 
far from home for months, just 
because a dishwasher had failed. 
During a chat with another friend, 
I realised water leakages are a big 
problem as well. My friend had 
to replace all the furniture in his 
basement, just because a pipe 
broke while he was at work. 

“Smoke detectors are 
mandatory, as per the regulations, 
but if there’s nobody home to 
react, the alert is not forwarded.” 
So Philippe put his maker mind 
to work and built this Internet of 
Things home safety system. 

A Raspberry Pi runs Windows 10 
IoT Core, and monitors smoke and 
fire alarms and water leakages. If 
it detects a fault, the cloud system 
triggers actions. These include 
turning on the fire bell, or closing 


the main water entry to the house. 


It can even send messages to 
Philippe’s mobile phone, or his 
neighbours. “If the system is 
stable enough, I would consider 
notifying 911 too,” says Philippe. 
“I get alerts through SMS, 
using Twilio API (twilio.com). I 


Fire and water are a risk to any home, but one 
maker uses his Raspberry Pi with Windows 10 IoT 
Core to monitor his home and get instant alerts 
to any problems 
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home sale 


also used Azure Notification Hub 
(azure.microsoft.com) to send 
alerts to laptops, smartphones, 
and tablets. 

“Tm inspired by real challenges, 
expressed by real people,” adds 
Philippe. “I have a new version 
of this concept, more 
modular and with a 
cleaner look.” 
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MIRROR 


Mirror, mirror on the wall, show me the latest news and all! 
This Pi-powered magic mirror delivers much more than your reflection 


hen attempting to 
purchase one-way 
observation mirror 


glass for his latest project, Jens 
Marchewka got some strange 


> GG Mirastar reactions from the suppliers he 
bservalion phoned, such as “What do you want 
mirror & 
ECE to do with that? No, I don't want to 
29FvoCo know, bye.” 

> LCD monitor He needed it to create a ‘magic 

mirror’ that displays information 

> Wood to make t Cube : 
OAE on an LCD screen behind the 

ne reflective gass panel Angered 
GERGER by an earlier project by Michael 


Teeuw (magpi.cc/29y06Yk), Jens 
wanted a mirror that could show 
articles from his favourite news 
sources, along with weather and 
calendar info. 

Not wanting to place ugly buttons 
down the side, he opted instead to 
use one-word voice commands to 
control the mirror’s display. For 
this, Windows’ built-in speech 
recognition system came in useful, 
although Jens experienced a few 
teething troubles. “I was using 
recognition without a grammar and 
that didn’t work properly... it [kept] 
recognising words [that] no one 
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The interior of the fully 
installed mirror; at the 
bottom-right you can 
see the Pi 


Calendar events are 
shown top-left, with 
weather top-right. 
Say ‘news’ to see the 
latest headlines 
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feature 


was speaking and even activated 
the radio. This is easy to avoid if a 
grammar is used.” 

The whole build process took 
Jens only ten hours, including the 
construction of a wooden case to 
frame the mirror glass and enclose 
the LCD monitor, Raspberry Pi 2, 
and cabling behind it. To help keep 
everything firmly in place, he added 
a toeboard border to the front of 


The future is bere 
swith the internet * 


yout mirror! 


the frame. He then painted the 
case black: “While constructing the 
frame, you should remember that 
the paint will take [up] space, so 
you need to keep that in mind and 
not build it too close.” 

Jens used a 24-inch LCD liyama 
monitor for his project, but any 
model or size could be substituted, 
so long as it has a good black level 
to achieve a nice mirror effect. 
Jens also notes that the monitor 
case needs to be disassembled to 
position the LCD panel as near 
as possible to the mirror. While 
his LCD screen is fully powered 
24/7, he’s working on a setup for 
scheduling its power via CEC. 

Along with news and weather, 
Jens’s magic mirror shows calendar 
events — including fixtures for his 
favourite football team, Schalke 
04 — obtained via the iCal web 
calendar. “You can define more 
than one iCal source and assign 
a colour to each... that makes it 
possible to have multiple events 
shown in different colours.” Jens 
has also added internet radio 
playback to the mirror, and is 
planning to use face recognition for 
displaying personalised events and 
news for him and his wife. 


THE MAGIC OF 
WINDOWS 10 IOT 


User interface design 

One of the main reasons Jens 
chose to use Windows 10 loT 

Core for this project, along with 

his experience as a Windows 
developer, is how easy it is to 
design custom user interfaces that 
look polished. 


Speech recognition 
Windows’ built-in speech 
recognition comes in handy for 
the magic mirror. Jens simply 
created a SpeechRecognizer 
function with a list of commands. 
The mirror runs a continuous 
speech recognition session. 


irer = noe Speeches irer t) 
straints Assi SpeechRacopnst bend istconstraiat (ses oy irel} 


recors 
recognizer. Con 


Syndication client 

The detailed news is sourced 
from RSS feeds, using the 
SyndicationClient class within the 
Windows framework. “It's a very 
comfortable class for parsing RSS 
feeds,” Jens tells us. 
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WINDOWS 10 IOT CORE 


GETTING STARTED WITH 


WINDOWS 10 
IOT CORE 


Prepare your Raspberry Pi 3 for working with Windows 10 IoT Core 


efore we can start using 
Windows 10 IoT Core, we 
need to get it installed 


on the Raspberry Pi. The best and 
recommended way to do this is via 
the IoT Dashboard on Windows 10 
systems; this then easily allows 
you to program a Windows 10 
Raspberry Pi using Visual Studio. 
Let’s get started! 


>STEP-01 

Prepare your PC 

To start with, make sure your PC 
or laptop is updated to the latest 
version of Windows 10, or at least 
version 10.0.10240. You can check 
this by clicking the Start button 
and typing winver. Once that’s 
checked and you’re properly 
updated, you’ll need to download 
and then install the IoT Dashboard 
from the link here: 
magpi.cc/2ah13dt 


From the IoT Dashboard, you can 
also find sample projects and soon 
you’ll be able to connect to the 
Azure IoT cloud service. 


>STEP-02 
Get the right image 
For the Raspberry Pi 3, you need to 
get yourself signed up for the free 
Windows Insider Program 
(insider.windows.com). You’ll 
then need to find and download the 
latest version of the Windows 10 
IoT Core Insider Preview from here 
(pick the highest number): 
magpi.cc/29Ugtoz 

Go to where you downloaded it 
and double-click on the ISO file to 
enter it, then click on the installer 
inside to get your PC set up to 


write the SD card properly. Follow 
the on-screen instructions in 
the wizard. 


>STEP-03 

Write to the disk 

Once the installer is finished, 
launch the IoT Dashboard we 
downloaded in step 1. From here 
we can write to the SD card. First, 
click ‘Set up a new device’. Select 
Custom from the ‘Device type’ 
menu and then click Browse right 
below that to find the image. The 
image lives in: 

C:\Program Files (x86)\ 
Microsoft IoT\FFU\ 
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pimeoad 


Try some samples 


Custom 


raspberrypi.org/magpi 


My devices Set up a new device 


First, let's get Windows 10 loT Core on your device 


Device type 


Flash the pre-downloaded image file (Flash.ffu) to the SD Card 


~~ 


>STEP-05 
Configure the board 
Once you’ve found your Pi, you can 
configure it by clicking the pencil 
icon next to it. From here you can 
launch Windows Device Portal, 
which has some basic settings 
you can edit. As well as setting up 
wireless networking if you need 
to, it’s also a great idea to seta 
There will be a Raspberry Pi folder username and change the default 
in there containing the file password. The latter is 
Flash.ffu. Select that and click p@ssword, which you’ll need to 
Install/Download and install. know before changing it. It’s just 
good InfoSec! 


= o 


>STEP-06 

Start making 

You’re ready to get going! You 

may have noticed there’s an 

option to try out samples on the 
>STEP-04 side column, so if you want to 
Networking test out a basic project from the 
For our tutorials, and in general, list, you can do so. Just select the 
you need to be able to connect to Raspberry Pi from the drop-down 
the Raspberry Pi over the network list and you’re off. 
to quickly and easily program it. To program it further, we’ll 
It’s recommended to connect it connect up Visual Studio, which 
via Ethernet to start with if you we’ll cover in our first tutorial 
can. Go to ‘My devices’ and you'll over the page... 
be able to find the Raspberry Pi, 
so you can configure it once it’s menan 
turned on; this includes setting up D W dnce Deploy and run 
access to your wireless network to N ES 2 
use it in the future. 


CS Connect to Azure 


My devices 


internet radio 


Core Blockly 


R, Signin 


$B Settings 
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PHIL KING 


When not sub-editing The MagPi 
and writing articles, Phil loves to 
work on Pi projects, including his 
two-wheeled robot. 
@philking68 


BUTTON- 
ACTIVATED 


Create a simple physical computing project using an LED and a push button 


ou’ve downloaded Windows 
10 IoT Core, installed it on 
an SD card, and set up your 


Raspberry Pi as an IoT Core device? 
It’s time to start coding it, using 
Visual Studio 2015 on a Windows 10 
PC. Let’s start with a simple project 
that uses a push button to toggle 


> 1x solderless 
breadboard 


» 1x tactile push 


button an LED... 
>1xLED 
Connect up your Pi 
21x 33e restol Before commencing, you’ll need the 
> eee IP address of your Raspberry Pi, as 
ores shown in My Devices in Windows 


10 IoT Core Dashboard. You’!l also 
need Visual Studio 2015 Community 
installed, which you can find here: 
magpi.cc/2adz7Hw 

First, let’s wire up our electronic 
components on a breadboard. It’s 
best practice to turn the Raspberry 
Pi off while doing so. As shown 
in the diagram, we connect the 
shorter, negative leg of the LED 
to GPIO 6 on the Pi. We connect 
its longer, positive leg to a 3330, 
resistor; the other end of the latter 
is connected to the Pi’s 3V3 pin. This 
is what’s known as an ‘active low’ 
configuration, as when the GPIO pin 
is set low, current will flow through 
the LED and light it; when the pin is 
set high, it will turn off. 

Next, we’ll wire up the tactile push 
button, which straddles the central 
groove of the breadboard. One pin 
is connected to GPIO 5, while the 
d other (on the same side) is wired 
Ej to GND. Again, this is an active low 


p_a 
[GPIO} 
Raspberry Pi 3 Model 8 v1.2 
Raspberry Pi 2015 
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The simple breadboard circuit is connected 
to the GPIO pins on the Raspberry Pi 


configuration: the signal is high 
by default and goes low when the 
button is pressed. When it’s all 
wired up, turn on the Raspberry Pi. 
Note that the Pi should be in headed 
mode (which is the default) for this 
project. If not, you’ll need to set it in 
PowerShell on your main Windows 
10 PC - see magpi.cc/29K4XWH. 

Now, on your Windows 10 PC, 
download the code examples, 
including PushButton for this 
project, from the GitHub repo: 
magpi.cc/29Qwut8. Right-click 
the zip folder and extract all files, 
then open samples-develop\ 
PushButton\CS\PushButton.csproj 
(the Visual C# project file) in Visual 
Studio; if not done already, you'll be 
prompted to enable Developer Mode 
on your PC. 

Select ARM for the target 
architecture. Go to Build>Build 
Solution. This process may take 
awhile. When finished, select 
Remote Machine from the Device 
drop-down arrow, enter the IP 
address of your Raspberry Pi, and 
select None for the authentication 
type. Press F5 to deploy and debug. 
Once it’s successfully deployed, try 
pressing the push button on your 
circuit; the LED should light up. 
Each time you press the button, the 
LED should toggle its state. 


Covering the code 

Let’s take a look at the code in the 
MainPage() element to see how this 
works. At the top, we open the GPIO 
pin resources we’ll be using... 
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We assign the LED pin a high value 
to make sure it’s turned off to begin 
with. When we change the drive 
mode to Output, it will immediately 
drive the latched output value onto 
the pin: 


We then set up the button pin. 

Since the Raspberry Pi 2 and 3 have 
built-in pull up resistors that we can 
activate, we don’t need to add an 
external one. 


Next, we connect the GPIO interrupt 
listener, which is called each time 
the button pin changes state. We 
also set the DebounceTimeout 
property to 50ms to filter out 
spurious events caused by 
electrical noise. 


In the button interrupt handler, 
we look at the edge of the GPIO 
signal to determine whether the 
button was pressed or released. 
If pressed, we toggle the state of 
the LED: 


Finally, we want to update the user 
interface with the current state of 
the pin, so we invoke an update 
operation on the UI thread. 


This tutorial has been adapted from Push 
Button Sample, from the Windows loT 
team consisting of Daniel Kuo, Tycho's 
Nose, and Liz George, from the Microsoft 
Projects site: magpi.cc/29K5xne 


Select ‘Remote 
Machine’ and enter 
the IP address 

or name of your 
Raspberry Pi 


The code that 
controls the circuit 
can be found in the 
MainPage() element 
of the project 
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INTERNE I- 
CONNECTED 


LED 


You'll 
Need 


> 1x Solderless 
breadboard 


> 1x LED 
> 1x 5602 resistor 


> 2x Jumper wires 


ou now know how to 
light an LED by pressing 
a button on Windows 10 
IoT. Let’s now use the IoT 


part of the software to have an LED 
controlled by the internet! 


Prepare your Pi 
Turn your Raspberry Pi off and 
wire up the circuit as shown in the 
Fritzing diagram. It’s a simple one 
so it shouldn’t take you very long. 
Next, you’ll need to download 
some code to get the whole setup 
working: MainPage.cs, which is a 
small part of the project. Grab it 
from here: magpi.cc/2a5GorP. 
Open up Lesson_201.sln and then 


Take information from the 


internet to light an LED, 


connecting to the Internet of 
Things, and becoming part of 
the World Map of Makers 


open up MainPage.xaml.cs. This 
needs to be modified to be able 
to run the LED script we want to 
write, so replace all the code with 
the full version from here: 
magpi.cc/2a7rNgL. 

Once that’s done, we can create 
the class file. From the main menu, 
select Project > Add Class... The 
Add New Item dialogue will open 
and default to Visual C# Class. As 
mentioned before, we’re calling it 
InternetLED.cs. 

To begin with, we need to add 
‘using’ lines at the top of the file 
so the code can reference the GPIO 
device, web interfaces, and the 
system diagnostics. 
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using System; 

using System.Diagnostics; 
using System.Net.Http; 

using System. Threading. Tasks; 
using Windows.Devices.Gpio; 


namespace Lesson_201 


{ 


Inside the class brackets, add the 
following lines. The first three 
lines are for controlling the GPIO, 
the next line allows us to adda 
delay if we don’t get a response for 
the web API call, and the last two 
lines store the state of the LED (on 
or off). 


class InternetLed 
{ 

private GpioController 
gpio; 

private GpioPin 
LedControlGPIOPin; 

private int 
LedControlPin; 

private const int 
DefaultBlinkDelay = 1000; 

public enum eLedState { 
Off, On Fs 

private eLedState _ 
LedState; 


Now, add the class constructor 
code which will store the value 
of the pin used to control the 

LED, interacting with the GPIO 
controller section of the class. 
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Join 4,000 other makers on the World Map of Makers, and light up their LEDs too! 


public InternetLed(int 
ledControlPin) 
il 

Debug. 
WriteLine("InternetLed: :New 
InternetLed") ; 

LedControlPin = 
ledControlPin; 


} 


Now we add code that initialises 
communication with the Pi’s GPIO. 
It first sets up the GPIO to be used 
for the LED, and then allows us to 
see the current pin value: 


public void InitalizeLed() 
{ 
Debug.WriteLine("InternetLed 
::InitalizeLed") ; 
gpio = GpioController. 
GetDefault(); 
LedControlGPIOPin = gpio. 
OpenPin(LedControl1Pin) ; 
LedControlGPIOPin. 
SetDriveMode(GpioPinDriveMode. 
Output) ; 
GpioPinValue startingValue = 
LedControlGPIOPin.Read(); 
_LedState = (startingValue 
== GpioPinValue.Low) ? 
eLedState.On : eLedState.Off; 
} 


This part allows us to interact with 
the LED, depending on its state: 


public eLedState LedState 


{ 
get { return _LedState; } 
set 


{ 
Debug.WriteLine("Interne 
tLed::LedState::set " + value. 
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ToString()); 
if (LedControlGPIOPin != 
null) 


GpioPinValue newValue 
= (value == eLedState. 
On ? GpioPinValue.High : 
GpioPinValue.Low) ; 


LedControlGPIOPin. 
Write(newValue) ; 
_LedState = value; 
} 
} 


Now add a part that allows us to 
blink the LED on or off. If the LED 
is on, it’s switched off. If it’s off, it 
gets switched on. Simple! 


public void Blink() 


{ 
if (LedState == eLedState. 


On) 
{ 
LedState = eLedState. 
off; 
} 
else 
{ 
LedState = eLedState.On; 
} 
} 


We can now actually start using 
information from the internet. 
Start out by setting up a way to read 
a page on the web and then execute 
it. Once it’s been read, output 
the returned string to the debug 
channel so you can see it while 
running the project. 

Finally, we determine what the 
value of the delay is and return it 


for the 
rest of the 
code to use. 


const string 
WebAPIURL 
= “http:// 
adafruitsample. 
azurewebsites.net/ 


TimeApi" ; 
public async Task<int> 
GetBlinkDelayFromWeb() 
{ 
Debug.WriteLine("Interne 
tLed: :MakeWebApiCal1") ; 
string responseString = "No 
response"; 
try 
{ 
using (HttpClient client = 
new HttpClient()) 
{ 
responseString 
= await client. 
GetStringAsync(WebAPIURL) ; 
Debug.WriteLine(String. 
Format("Response string: [{@}]", 
responseString) ); 


} 
} 
catch (Exception e) 
{ 
Debug.WriteLine(e. 
Message); 
} 
int delay; 
if (lint. 
TryParse(responseString, out 
delay)) 


{ 
delay = DefaultBlinkDelay; 


} 
return delay; 
} 

} 

} 


Once all the code is entered, you 
can build the solution and run the 
code on your Pi. If you’re having 
issues, the code listing has the full 
solution to check against. 

This tutorial has been adapted from 
World Map of Makers by the Windows 
loT team consisting of David Shoemaker, 
Anthony Ngu, and Aparajita Dutta, from 


the Microsoft Projects site: 
magpi.cc/2a5GaPD 
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TALKING LIGHT 


Create a customisable, talking light sensor that lets you know 
when the amount of light hitting it is just right 


n the last two tutorials, we First of all, with your Raspberry Once again, download everything 
> 1x Solderless learnt how to use a button Pi off, wire up the circuit as shown from here: magpi.cc/2a9OEW1. 
preadboard to turn on an LED, and then in the Fritzing diagram, paying Open up Lesson_204.sln in 
> 1x Light sensor how to use a web API call to blink careful attention to the orientation Visual Studio and open the 
(pnoioresizton another LED. Let’s bring both of of the chip. Refer to Fig 1on the next mainpage.xaml.cs file. We need 
> 1x 5602 resistor these concepts together and make page for notes on the orientation. to do a bit more editing to get it 
> Male-to-female a device that takes user inputs from Connect a speaker or headphones working, so we’ll run over that first. 
Jumper wires two dials (variable resistors) and now if you want to use them. Add the following lines to the top 
> Headphones or a light sensor, and then uses that of the MainPage class, right after the 
speaker (optional) information to tell you a result using The main code { bracket. First, we need to let the 
an online text-to-speech API. Let’s As with the last tutorial, we'll code know how much voltage the 
play it bright, or not! download a project to work from. chip is getting: 
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Credit: lainf 


The variable resistor, or potentiometer, is a 
voltage divider that, when twisted, allows for an 
output that has a variable voltage 

const float ReferenceVoltage = 
5.0F; 


Then we tell it what the channels 
will be detecting. The third line is 
for the light sensor: 


const byte 
LowPotentiometerADCChannel = ®; 

const byte 
HighPotentiometerADCChannel = 
1; 

const byte CDSADCChannel = 2; 


Here’s the text strings we want to 
use for when the Pi talks to us: 


const string 
JustRightLightString = "Ah, 
just right"; 

const string LowLightString = 
"I need a light"; 


const string HighLightString 
= "I need to wear shades"; 


This part will help record the state 
of the light sensor: 


enum eState { unknown, 
JustRight, TooBright, TooDark}; 

eState CurrentState = eState. 
unknown; 


We now tell the code which ADC 
chip we’re using: 


MCP3008 mcp3008 = new 
MCP3008(ReferenceVoltage) ; 


We’re going to connect to the 
speech-to-text part of the 
Windows 10 Cognitive services, so 
we add: 


private SpeechSynthesizer 
synthesizer; 


And finally, we add a little bit so we 
can check the ADC at a set interval: 


public Timer timer; 
With the start of the class filled 


out, we can now fill out some of 
the MainPage constructor (public 


The setup may end up looking a bit messy once you're done, but make use 
of colour-coding so you know what wire is related to what part of the system 
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MainPage()), 
right after this. 
InitializeComponent();. 
Here we add a line to start 
the speech synthesiser and 
another to initialise the ADC: 


synthesizer = new 
SpeechSynthesizer(); 
mcp3008.Initialize() ; 


Now we can set up a timer in the 
OnNavigateTo method. After 

Debug. WriteLine("MainPage::OnN 
avigatedTo");, add the following: 


timer = new 
Timer(timerCallback, this, 0, 
1000); 


Now we have the timer callback 
being called, let’s fill it out. After 
the } following ‘return;’, add the 
following lines. Let’s set the new 
light state and assume it’s just 
right to start: 


eState newState = eState. 
JustRight; 


Next, we want to read the values of 
the dials from the ADC, so we use: 


int lowPotReadVal = mcp3008. 
ReadADC(LowPotentiometerADCCha 
nnel); 

int highPotReadVal = mcp30e8. 
ReadADC(HighPotentiometerADCCh 
annel); 

int cdsReadVal = mcp300e8. 
ReadADC(CDSADCChanne1) ; 


Fig 1 The notch on the 
chip denotes that this 
is where the ‘front’ 

of the chip is. In the 
Fritzing diagram, this 
notch is on the left 
side of the chip 


Convert these readings into 
voltages to make them easier 
to use: 


float lowPotVoltage = mcp30e8. 
ADCToVoltage(lowPotReadVal) ; 

float highPotVoltage = mcp3008. 
ADCToVoltage(highPotReadVal1) ; 

float cdsVoltage = mcp30@8. 
ADCToVoltage(cdsReadVal1) ; 


Next, we’ll make sure we can 
read the values when the code is 
running from the debug: 


Debug.WriteLine(String. 
Format("Read values {0}, {1}, 
{2} ", 

lowPotReadVal, 
highPotReadVal, cdsReadVal)); 

Debug .WriteLine(String. 
Format("Voltages {0}, {1}, {2} 


n 
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lowPotVoltage, 
highPotVoltage, cdsVoltage)); 


We now check if the state of the 
light is below the values set by the 
variable resistors: 
if (cdsVoltage < lowPotVoltage) 
í 


newState = eState.TooDark; 


Next in the chain is to see if it was 
too high: 


if (cdsVoltage > 
highPotVoltage) 
í 


newState = eState.TooBright; 


} 


And then we let the code know 

to use a different method, to 
determine what to do with the state 
of the light: 


await 
CheckForStateChange(newState); 


The CheckForStateChange code 
has been mostly completed in 

this example, but you’ll need 

to add the following under ‘use 
another method to wrap the speech 
synthesis functionality’ to do 

just that: 


await TextToSpeech(whatToSay) ; 


Now we can add the part that lets 
the Pi talk to us! Under async, where 


it says ‘insert code’, 
insert the following code 
which first converts text input 
into a stream, and then plays 
the audio: 


SpeechSynthesisStream 
synthesisStream; 

synthesisStream = await 
synthesizer .SynthesizeTextToStr 
eamAsync(textToSpeak) ; 


media.AutoPlay = true; 
media. 
SetSource(synthesisStream, 
synthesisStream.ContentType) ; 
media.Play(); 


Coding the ADC 

Now we’re done with the 
MainPage code, it’s time to code 
up the ADC. Open up MCP3008.cs 
from the project file. 

We need to start by creating 
an initialising method to set up 
communication with the SPI 
bus the ADC chip runs on. Just 
after the line ‘Debug. WriteLin 
e(“MCP3008::Initialize”);’ add 
the following, starting with the 
configuration of the SPI bus and 
telling it the ADC’s clock speed: 


try 
{ 
var settings = new 
SpiconnectionSettings(SPI_CHIP_ 
SELECT_LINE); 
settings.ClockFrequency = 
3600000; 
settings.Mode = SpiMode. 
Mode@; 


This line will return all SPI devices 
on the system: 


string aqs = SpiDevice. 
GetDeviceSelector(); 


This line finds the SPI bus 
controller from the 
previous line: 
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READE ma 


adafruitsample 


There's a whole host 


of other tutorials on 
GitHub where this 
project lies; give them 
a look if you want to try 
out more! 


And the rest of the code creates an 
SPI device using all the information 
we just grabbed: 


The light sensor, or 
photoresistor, changes 
resistance depending 
on the amount of light 
hitting it. Like the variable 
resistor, this changes the 
voltage at the output 
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Now we have the information for 


the chip, we’re able to add code so 


we can read it: 


Remember when we were turning 
the input into a voltage so it was 
easier to read? We need to add 

a helper method here to work 
with that: 


It's game time 
Your project is ready! Run the code 
with the setup in a normally lit 
area. The output window will show 
you the voltages read from the 
ADC: the lower-boundary resistor, 
the higher-boundary resistor, and 
the light sensor. It should look 
something like this: 


Turn the lower-boundary 
potentiometer, watching the value 
of the first number change. Adjust 
it so it’s just a touch lower than the 
light sensor reading. Do the same 
with the other resistor, turning it to 
be just above the light sensor. This 
is now our ‘just right’ zone of light. 
Now, when you put your hand 
over the light sensor, it will print in 
the output window ‘I need a light’; 
it will also say it to you if you have 
speakers or a headphone connected. 
Experiment with uncovering and 
shining a light on it to see just how 
sensitive it is. 
This tutorial has been adapted from Bright 
or Not? by the Windows loT team consist- 
ing of David Shoemaker, Anthony Ngu, 


and Aparajita Dutta, from the Microsoft 
Projects site: magpi.cc/2abUvxo 
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The pan-and-tilt 


mechanism enables the 
Camera Module to move 
with 360° of freedom 


The Discoverer 
took nearly six 
months to build 


There's a 350m 
range for 
remote control 


Ituses a 
Navilock 
NL-602U GPS 
receiver 


The original 
chassis was 
a smaller 
IKEA box 


The pan-and- 
tilt kit features 
two mini-servos 


INGMAR STAPEL 


Ingmar has been building Pi- 
powered robot cars since 2012. 
He's also working on a security 
robot for the home. 
custom-build-robots.com 


A WiFi router connects the 
Discoverer to a remote laptop 
for live video and steering 


Built from a kit, the metal 
detector is mounted ona 
PVC pipe arm at the front 


RER 


METAL-DETECTOR ROBOT 


This smart Raspberry Pi robot is equipped with a metal detector, 
along with GPS tracking and a pan-and-tilt camera 


e’ve seen all sorts of Pi- 

powered robots in our 

time, but the Discoverer 
is the first with a built-in metal 
detector. Mounted on a PVC pipe 
arm in front of the four-wheeled 
robot, the detector emits a beep 
whenever it passes over a metallic 
object. Prolific robot maker Ingmar 
Stapel, from Munich, came up 
with the idea after watching a TV 
show about people trying to find 
gold with a sophisticated metal 
detector. “I was immediately 
inspired to build my own affordable 
robot-car with a metal detector in 
order to discover some treasure in 
my garden,” he tells us. 
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The basis for the new robot was 
his previous cardboard car, which 
required some major adaptations. 
“First, I had to look for a different 
chassis that is also suitable for 
outdoor usage. Second, I needed 
a metal detector that fits to the 
robot-car and the Raspberry Pi 
to ensure remote-controlled 
treasure hunting.” 

For the chassis, he useda 
plastic storage box to contain 
all the electronics, adding PVC 
piping around the exterior to hold 
a pan-and-tilt camera and the 
metal detector. At first, Ingmar 
tried using a cheap electric-cable 
detector from a DIY store, but its 


coil was too small to detect metal 
in the ground. He then came across 
the Gary’s Pulse-AV metal detector 
(magpi.cc/1XdKBeK). “With 
support from Gary, I was able 
connect the metal detector to the 
Raspberry Pi and to get everything 
working.” This involved using a 
step-down converter to change the 
detector’s 12V output to 3.3V fora 
GPIO pin on the Pi. 

As Ingmar wanted the Discoverer 
to stream live video to a laptop, 
it would need a camera. After 
mounting a Pi Camera Module on 
the front of the chassis, he found 
the angle of view was too limited. 
“I bought the pan-and-tilt kit 
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and mounted it in the middle of 
the robot and I got a much better 
overview.” Some trial and error 
was involved in getting the live 
video streaming to work with very 
low latency, since even the tiniest 
delay would make remote control 
difficult. In the end, he used MJPG- 
streamer (magpi.cc/24F96k6) 
with some patches to get it to run 
on the Pi3: “The video is very fast 
with a very low latency... it is even 
possible to make some robot-car 
races in our apartment.” 

While originally just remote- 
controlled, the Discoverer is now 
able to move autonomously using 
a GPS receiver, Sense HAT (for the 
compass), and a Python program 
Ingmar had already developed. 
“Tt is still in a beta version, but 
it is already able to import a KML 
file with GPS waypoints generated 
via Google Earth. Imported into 
my Python program, the robot- 
car is able to drive from one GPS 
waypoint to the next.” When it’s 
finalised, he plans to include a 
manual in his first book, due to 
be published (in German) this 
autumn. While the Discoverer is 
mainly for fun treasure hunting, 
Ingmar thinks it could also have 
some serious applications, such 
as detecting mines in war zones. 


Above The 
Discoverer is loosely 
based on Ingmar's 
earlier cardboard car 
(magpi.cc/1VQv8QJ), 
which has live 

video streaming 


Left Unable 

to fit all the 
components into 
the original IKEA 
plastic storage 
box, Ingmar 
replaced it with 
a larger one 
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The project 
cost $500 AUD 
(£280) to build 


It currently 
covers 2-3km 


per charge 


The board can 
currently reach 
up to 15km/h 


Tim plans a 
battery and 
ESC upgrade 


Build recipe 
is available 
on GitHub 


TIM MAIER 


Tim is currently studying for a Bachelor 
of Information Technology degree at 
Queensland University of Technology, 
with plans to major in Computer Science. 
magpi.cc/29Burvi 


MOTORISED 
SKATEBOARD 


A university assignment allowed one student the chance to realise 
his dream of building the latest in whizzy commuter gadgets 


y now we’re sure you’re 
aware that e-boards have 


officially become a ‘thing’. 


From knee-driven mini-Segways 
and two-wheeled ‘hoverboards’ 
to standard motorised decks, the 
streets are filled with wheeled 
commuters. And while Marty 
McFly may have failed to deliver 
on the true hoverboard of our 
dreams, search online for an 
electric skateboard and you’ll find 


? The family’s 3D printer 
provided the Raspberry Pi 
casing for added protection 
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the next best thing, albeit witha 
hefty price tag. 

So when Queensland University 
of Technology student Tim Maier 
was assigned with the task of 
‘building something with a 
Raspberry Pi’, he already knew 
what he planned to create. 

“Building an electric skateboard 
had been something on my mind 
for some time, as buying one was 
not a viable option,” Tim explains, 


when we ask him if he had 
considered any other directions for 
his project. “So when we were told 
about the task, it all kind of linked 
up and I started to do my research 
on what to buy.” 

With a few requirements in 
mind, Tim started researching 
the perfect motor. He wanted 
to achieve an average speed of 
30km/h to aid his commute, and 
knew the motor would easily 


¢ Tim built a smaller deck 
to allow him to easily 
carry it around campus 


| The board uses standard 
wheels and trucks, easily 
6 acquired online 
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be one of the most expensive 
components of the build. Finally, 
he decided upon a Turnigy 
Aerodrive SK3, matching it with 
two 2200mAh lithium polymer 
(LiPo) batteries and a basic 
electronic speed control (ESC). 
Despite having to rely on 
YouTube and assorted literature 
to educate him on how to utilise 
Python, the biggest hurdle for 
Tim turned out to be the drive 


The perfect motor was chosen 
to reach speeds of up to 30km/h 


Spurred by the positive response, 
he’s provided the code and kit list 
on GitHub (magpi.cc/29Burv1), 
and plans to also create an 
instructional video of an upgraded 
design for anyone wanting to 
make their own. The Pi Skate 2.0 
will house more batteries for 
longevity, a higher-quality ESC 
for greater speed and the ability 
to brake, and possibly LED lights 
because, well, why not? And as 


The motor itself is controlled 
by a Pi and Wii Remote 
(a Wiimote to those in the know) 


system. “Finding a way to attach 
the motor mount to the skateboard 
truck was a huge fiddle.” He 
ended up creating a makeshift 
U-bolt system, though he plans to 
upgrade the mounting layout when 
attaching a new ESC. 

The motor itself is controlled by 
a Pi and Wii Remote (a Wiimote to 
those in the know). Holding the 
‘T and ‘2’ buttons will connect the 
Wiimote to the Pi. The ‘B’ button 
activates the motor, while ‘up’ and 


‘down’ on the D-pad control speed. 


Upon completing the build, 
Tim has been met with thousands 
of YouTube views and calls for 
how-to guides and board sales. 
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for the Wiimote? Tim hopes to 
move the board’s control system 
to a mobile phone or smartwatch, 
thereby reducing the bulk of the 
console controller. 
Of his future in the digital 
making industry, Tim suggests, 
“I will most probably venture 
into a career within the computing 
and engineering field, but haven’t 
really thought too much about 
what area I will specialise in. 
Pm keeping my options open 
as it’s such a broad field.” In 
the meantime, his continued 
experimentation with Raspberry Pi 
will lead to further YouTube videos 
as and when he builds projects. 


yA 
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The train system is fully automated 
and based on Transport for 
London's API. Trains are tracked 

as they move, and passengers get 
real-time updates on small displays 


» Around 20,000 
LEGO bricks 
were used 


» It took one- 
and-a-half 
years to build 


» Over 46,000 
people have 
interacted with 
the blog 


» 17 LEGO kits 
were used 


» Most LEGO 
kits were from 
the Creator 
Expert series 


F 


OF 


The lights in buildings are controlled 
by the Raspberry Pi system, and the 
disco lights respond to visitors to the 
Internet of LEGO blog 


The Raspberry Pi acts as 

a control centre for all the 
transport and buildings. It's 
accessed via a web browser 


HE INTER 


One maker is taking a love of LEGO to a whole new level with 
Raspberry Pi. Take a tour of this incredible internet-connected 
cityscape being built brick by brick 


e love LEGO and the 
internet, so what could be 

finer than this ‘Internet of 
LEGO’ project? Well, discovering 
the Raspberry Pi serving as its 
brain, and catching up with its 
maker to learn all about this 
amazing connected city. 

“The Internet of LEGO is a living 
project where I set out to learn 
everything about the Internet 
of Things,” says Cory Guynn. 
Packed with sensors, the city 
reports to a Raspberry Pi that acts 
as its brain. Cory has used this 
to create the Internet of LEGO 
blog (internetoflego.com). 
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“I grew up playing with LEGO 
bricks and model trains, which 
taught me about construction and 
electronics, and allowed me to 
be creative. The use of LEGO also 
allows me to represent a city or 
build prototype systems easily. 
Plus, it gives me an excuse to buy 
a bunch of LEGO bricks in my 
thirties,” laughs Cory. 

“A Raspberry Pi Model B+ is 
the heart of my city,” he reveals, 
“and that was the starting point 
of the project.” The Raspberry 
Pi is attached to Arduino boards 
that control most of the GPIO 
operations. Cory also uses Cactus 


Micro Rev2, BlueDuino, WeMos 
and NodeMCU boards, along with 
a Wio Link and BeagleBone Green. 
The city itself is complex, with 
many structures and buildings 
hooked up to a huge range 
of sensors: RFID, ultrasonic 
proximity, infrared, and magnetic 
reed switches are used to keep 
track of the city environment. 
The train system is Cory’s 
favourite part of the city. “I love 
seeing things in motion,” he 
reveals. “There are several things 
that I’ve been able to do that make 
for a dynamic environment.” 
Cory has built a train scheduling 
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system using the Transport for 
London API. This system displays 
the schedule on an OLED screen 
and switches to the train track to 
match the destination. 

The trains are controlled by 
WiFi and an infrared transmitter 
attached to a tower. Infrared 


Cory has developed a huge amount 
of software to control all the 
structures in the Internet of LEGO 


sensors are used to detect 
incoming trains and trigger a 
crossing signal (with a servo 
controlling the arm, and LEDs 
for lights). 

“Everything is connected to 
an Arduino Mega, which is then 
USB-tethered to the Raspberry Pi,” 
explains Cory. 

He has developed a huge amount 
of software to control all the 
structures in the Internet of LEGO. 
“The Johnny-five.io robotics 
framework made programming 
sensors and servos easy. I wrote 
a few projects, including a train 
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THE INTERNET OF LEGO 


We love the detail 
of the Internet of 
LEGO city, with 
citizens going about 
their daily lives 


ppcucucuecess*® 


Multiple Raspberry 
Pi, Arduino, and 
BeagleBoard devices 
are used to make the 
Internet of LEGO work 


crossing, train track switch, 
elevator, motion detector, and 
city lights.” 

Most of the orchestration of 
the city and its many sensors 
is handled by Node-RED. “This 
system allows me to add inputs 
and outputs from any of my 


projects that can interact with one 
another,” says Cory. “For example, 
when somebody visits my blog, a 
REST call to Node-RED triggers an 
MQTT message to my disco lights, 
which turns on strobing LEDs in 

a LEGO club and also triggers the 
Palace Cinema marquee lights for 
five seconds.” 

Cory tells us he is indebted to the 
Open-source community, which 
has allowed him to learn so much 
about programming and hardware. 
“T hope to give back to the 
community through my projects 
and experience along the way.” 
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» HAL stands for | | f \ | | 


‘Heuristically 


programmed 


Algorithmic “Open the pod bay doors, HAL” are chilling words to anybody who has 
pene watched 2001: A Space Odyssey, apart from one maker who decided it 
ciao Would be a good idea to build HAL 9000 for real 


IBM with each 
letter shifted 


one backward 


» The total 
cost for the 
build was $99 
(including the 
Raspberry Pi) 


> All the parts 
are off-the- 
shelf computer 
components 


» The case 
is laser-cut 
acrylic covered 
in black paint 


The case is made from 
3mm black acrylic 
laser-cut into the right 
shape for HAL. It is 
spray-painted fora 
professional finish 


had this Raspberry PI 

Model B waiting to become 

something great,” says 
Djordje Ungar, “and what greater 
thing can acomputer hope for than 
to become the iconic computer 
from Stanley Kubrick’s 2001: A Space 
Odyssey? I mean, come on! 

“The first time I heard 
synthesized speech, I thought to 
myself: ‘Wow, how cool would it be 
if that was a voice of HAL 9000? 
It was when I stumbled upon 
Jasper, this amazing open-source 
project that allows you to control 
a computer with your voice, that 
I knew I had to make HAL.” 

Aside from the Raspberry Pi, all 


the other parts are off-the-shelf 
computer components that you 
can buy online. “I used a3mm 
thick black acrylic, and I’ve painted 
some parts to look metallic,” 
Djordje reveals. “The box is 300 x 
96 x 62mm, which is a bit larger 
than a tall carton of milk. 

“T examined a dozen movie stills 
from the film,” he continues. 
“I was only able to guess the actual 
size of the original HAL, so I based 
it off the lens. Some things like the 
number of holes on the speaker 
panel and the logo are spot on.” 

To allow HAL 9000 to see, 


Astripped-down web 
camera is fitted with 
a camera lens. This 


completes the HAL 9000 
look, and the web camera 
also provides the device 
with a microphone 


RP Bod 
eectere' 2° F see 2 Djordje added a webcam and 
e 
A USB speaker is fitted 125 50S ira camera lens. “I wanted to find 
inside the device near Wie AS ge ¢ * ca @ i 
the grille at the bottom. , S sai cae? eae * a super convex lens like the one 
. e . 
ar Ror sofiane provides EPSO A O AE EA from the movie, but lenses of that 
with a voice ~) e e ; i 
ee cee = cee A a F calibre are anything but cheap. 
, a e . 
O 0" E, Even the used ones were way too 
e e 
$e expensive. So I had to settle for 
. pA 
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A bargain camera lens is fitted 
inside the laser-cut acrylic case 

to form HAL 9000's famous single 
eye. Red LEDs complete the effect 


a cheaper, non-convex lens.” 
Luckily, he found a used one 

that he liked, via local classified 
advertisements: a Titanium Super 
Wide Lens 0.42x AF. 

“The lens is mostly for style, to 
give the whole build a more polished 
look, but it does also expand the 
field of view of the webcam a little. 


‘ 
; 
‘ 
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the case,” he tells us. The brain is 
the Raspberry Pi running the Jasper 
project (magpi.cc/29iKyxS). 

“The Jasper project offers a 
couple of TTS (Text-To-Speech) 
engines,” explains Djordje. 

“I had a couple of options, but I 
chose eSpeak (magpi.cc/29iKtdt) 
since I’m most familiar with it.” 


It works as a voice assistant, but it 
can play any WAV files, including 
the classic lines from the movie 


“The truth is: I didn’t need 
the webcam. I only needed the 
microphone. But since they come 
bundled together, having a webcam 
was a plus. I removed the casing 
and left the circuit board exposed, 
to make it as compact as possible. 
Then I glued it onto the ring that 
goes on the back of the lens.” 

For HAL 9000’s voice and brain, 
Djordje fitted a speaker and a 
Raspberry Pi inside the case. “My 
only criterion for the speaker was 
that it should be small and fit inside 
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It works as a voice assistant, but 
it can play any WAV files, including 
the classic lines from the movie. 

“I wrote a simple Jasper module 
that will play random WAV files.” 

Djordje’s friends are impressed 
by the project: “In a world where 
you can talk to your phone’s 
digital assistants, or ask Google a 
question with your voice, no one 
is blown away by the fact that 
HAL responds to voice commands, 
but everyone loved the case and 
wanted one.” 
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RGB LED 
TWEE T-O-METER 


Use the GPIO Zero Python library to control an RGB LED 
and see how well your tweets are doing 


RGB LED 
Breadboard 


Jumper wires 


3x 100 ohm 
resistors 


Twitter developer 
account 


TextBlob Python 
library 


Twython Python 
library 


Common cathode RGB 
LED. The longest leg will 
be the cathode and should 
be connected to ground 


eeping up to date with Twitter can be very 

time-consuming, especially if there are lots of 

tweets. What if you could see at a glance what 
the Twittersphere thinks about a certain topic? In this 
tutorial we’re going to build a simple RGB LED circuit, 
and program it to change colour to indicate whether 
the tweets that include a given hashtag or keyword are 
using positive, negative or generally neutral language. 


>STEP-01 

Install Python libraries 

Update your Pi to the latest version of Raspbian and 
download and install the additional software you’ ll need. 


sudo pip3 install twython textblob 


The resistors limit the current flowing 
through the LED and prevent damage 


You can use any size 
breadboard for this circuit 
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There are two libraries that make our project really 
easy. Twython allows you to contact Twitter using 
Python and collect tweets (you’ll need to register fora 
Python developer account - see step 5). Then, to read 
the tweets in the code, we’re going to use TextBlob, 
there are other libraries available, but this is one of 
the simplest. 


>STEP-02 

Do you like sausages? 

Let’s take a look at a simple example. Open a Python 3 
interpreter (either use the command line or IDLE) 
and type: 


>>> from textblob import TextBlob 

>>> sentence = TextBlob('I really like 
sausages, they are great') 

>>> sentence.sentiment.polarity 

0.5 


Any value for polarity greater than 1 indicates a 
positive sentiment (like); a value less than 1 suggests 
negative sentiment (dislike). Try changing the 
sentence and see how a different phrase will give a 
different result. Results will be more accurate if you 
have more text, although a 140-character tweet is 
normally good enough. 


>STEP-03 

Select your RGB LED 

Light-emitting diodes (LEDs) are cool. Literally. 
Unlike a normal incandescent bulb which has a hot 
filament, LEDs produce light solely by the movement 
of electrons in a semiconductor material. An RGB 
LED has three single-colour LEDs combined in 

one package. By varying the brightness of each 
component, you can produce a range of colours, 
just like mixing paint. There are two main types of 
RGB LEDs: common anode and common cathode. 
We’re going to use common cathode. 
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Deisis Settings «—-Keynand Access Tokens Permissions 


Application Settings 


Application Actions 


Regenerate Consumer Key and Secret range Aco Perms 


Your Access Token 


Token Actions 


Above Once you've created your Twitter app, generate 
the required access tokens; copy these into your code 


>STEP-04 

Connect up the RGB LED 

LEDs need to be connected the correct way round. 
For a common cathode RGB LED, you have a single 
ground wire and three anodes, one for each colour. 
To drive these from a Raspberry Pi, connect each 
anode to a GPIO pin via a current-limiting resistor. 
When one or more of these pins is set to HIGH (3.3V), 
the LED will light up the corresponding colour. 
Connect everything as shown in the diagram. 


>STEP-05 

Register as a Twitter API developer 

Anyone with a Twitter account can register as a 
developer, although you might be asked to provide 
a mobile phone number or other identification 
details. Once you’ve registered, you need to create 
a new application at apps.twitter.com. Click the 
button to create a new app and then fill in the 
required fields. Once that’s done, select the ‘Keys 
and Access Tokens’ tab and click on the ‘Create my 
access token’ button. 


>STEP-06 

Process some tweets 

Download or type up the code from the 
tweetometer.py listing. Add the Twitter API keys 
and tokens generated in step 5 at the appropriate 
places. Now pick a hashtag or keyword for testing. 
As this is US presidential election year, we found that 
using the name of one of the candidates generated 
more than enough data! Run the code: you should 
see arunning count of the analysed tweets on 

the console, and the LED should flash with each 
new matching tweet. Between new tweets, the 
LED will remain the colour of the sentiment with 
the biggest count. 
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RGB LED TWEET-O-METER 


tweetometer.py 


#Tweet-o-meter: Add your own Twitter API developer 


>PYTHON 3 


keys (lines 9-12) 


DOWNLOAD: 
magpi.cc/1WBerda 


# and choose your own keyword/hashtag (line 56) 
import time, sys 

from textblob import TextBlob 

from gpiozero import RGBLED 

from twython import TwythonStreamer 


# Add Python Developer App tokens and secret keys 

APP_KEY ='ENTER APP KEY HERE’ # <- CHANGE 

APP_SECRET = 'ENTER APP SECRET HERE' # <- CHANGE 

OAUTH_TOKEN = ‘ENTER OAUTH_TOKEN HERE’ # <- CHANGE 
OAUTH_TOKEN_SECRET = ‘ENTER OAUTH_TOKEN_SECRET HERE’ # <- CHANGE 


# Set our RGB LED pins 

status_led = RGBLED(14,15,18, active_high=True) 

# Set active_high to False for common anode RGB LED 
status_led.off() 

totals = {'pos':0,'neg':0,'neu' :0} 

colours = {'pos':(@,1,0), 'neg':(1,0,@), ‘'neu':(0,0,1)} 


class MyStreamer(TwythonStreamer) : 
def on_success(self,data): # When we get valid data 
if ‘text' in data: # If the tweet has a text field 
tweet = data[' text’ ].encode(‘utf-8') 
#print(tweet) # Uncomment to display each tweet 
tweet_pro = TextBlob(data['text']) # Calculate sentiment 
# Adjust value below to tune sentiment sensitivity 
if tweet_pro.sentiment.polarity > 0.1: # Positive 
print('Positive') 
status_led.blink(on_time=0.4, off_time=@.2, on_color=(0, 
Ə), n=1, background=False) 
totals['pos' ]+=1 
# Adjust value below to tune sentiment sensitivity 
elif tweet_pro.sentiment.polarity < -@.1: # Negative 
print( ‘Negative’ ) 
status_led.blink(on_time=0.4, off_time=0.2, on_color=(1, 
@), n=1, background=False) 
totals['neg' ]+=1 
else: 
print('Neutral') # Neutral 
status_led.blink(on_time=0.4, off_time=0.2, on_color=(0, 
1), n=1, background=False) 
totals['neu']+=1 
overall sentiment = max(totals.keys(),key=(lambda k: totals[k])) 
status_led.color = colours[overall_sentiment ] 
print(totals) 
print('winning: + overall sentiment) 
time.sleep(@.5) # Throttling 


def on_error(self, status_code, data): # Catch and display Twython errors 


print( “error: =) 
print( status_code) 
status_led.blink(on_time=0.5,off_time=0.5, on_color=(1,1,0),n=3) 


# Start processing the stream 


stream2 = MyStreamer(APP_KEY, APP_SECRET, OAUTH_TOKEN, OAUTH TOKEN SECRET) 


while True: 
try: 
stream2.statuses.filter(track='magpi') # <- CHANGE THIS KEYWORD! 
except KeyboardInterrupt: # Exit on Ctrl-C 
sys.exit() 


# Endless loop: personalise to suit your own purposes 


except: # Ignore other errors and keep going 


continue ee 
August 2016 MdgPi | 45 


Tutorial 


B veu 45) = = * Q Smath c- /home/pi - 6 EE pi@respberry: ~ 


a 


Wastebasket 


These are variable declarations: 
in C, a variable must be 
declared before you use it 


void main (void) 


í 
int a; 
int b = 3; 
int ¢; 


a=; 


eee 3 
WNKOHOOYVAULWNHeE F 


c=a+b; 
printf ("Tho result of adding Sd and wd is SAn”, a, b, c); 
} 


C can print the results of 


calculations to the command- 
line in formats you choose 


AN INTRODUCTION TO C 
VARIABLES & ARITHMETIC 


Doing some real work in C: creating variables and doing mathematical operations on them 


ARITHMETIC 
SHORTHAND 


Callows 
shortcuts for 
some common 
operations; 

for example, 


instead 

of typing 
a=a+1, 
you can just 
enter a++. 
Or for 


ai x3; 
you can enter 
a *= 3 


n some languages, you can create variables as 

you go along and put whatever data you want 

into them. C isn’t like that: to use a variable 
in C, you need to have created it first, and at the time 
you create it, you have to set what type of value it is 
going to store. By doing this, a block of memory of 
the correct size can be allocated by the compiler to 
hold the variable. This process of creating a variable 
is known as declaration. 


Integers 

There are several fundamental data types in C, but 
we’ll start by looking at one of the most commonly 
used: the int type, used to store an integer value. 


#include <stdio.h> 


void main (void) 
{ 
int a; 
int b = 3; 
int c; 


a= 2; 

c = a + b; 

printf ("The result of adding %d and 
%d is %d\n", a, b, c); 
} 
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The top three lines inside the main function here 
are declarations. They tell the compiler that we would 
like to use variables called a, b and c respectively, and 
that each one is of type int, i.e. an integer. 

In the second line, we see an example of an 
initialisation at the same time as a declaration: this 
stores an initial value of 3 in the variable b. Note that 
the values of a and c at this point are undefined; you 
might assume that a variable which hasn’t had a 
value stored in it is always 0, but that isn’t the case 
in C. Before reading the value from a variable, or 
using it ina calculation, you must store a value in it; 
reading a variable before initialising it is acommon 
error in C. 

The next two lines do some actual work with the 
variables we have declared. 


a= 2; 


This stores a value of 2 in the variable a, which 
will now have this value until it is changed. (The 
reason a is called a variable is that it can vary: you 
can change its value as often as you like, but only to 
another integer. The value of a variable can change, 
but its type is fixed when it is declared.) 


c = a + b; 
This line adds a to b, and stores the result in c. 
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AN INTRODUCTION TO C 


DECIMAL PLACES 


You can set the number of decimal places to display 


for a floating point type-specifier in printf by putting 
a decimal point and the number of places between the 
% and the f - so %.3 will show a float value with three 
digits after the decimal point. 


printf ("The result of adding %d and %d is 
%d\n", a, b, c); 


This is another use of the formatted print function 
we saw in the previous instalment. Note the three 
%d symbols inside the string: these are called format 
specifiers, and they are how you output numbers in 
C. When the printf function is executed, each %d is 
replaced by a decimal representation (d for decimal 
integer) of the variable in the corresponding position 
in the list after the string. So the first %d will be 
replaced by the value of a, the second with the value 
of b and the third with the value of c. 

Compile the program above and then run it. 

You should see this: 


The result of adding 2 and 3 is 5 


...in the terminal. 


Floating-point numbers 

So we can add two integers together; what else can we 
do? One thing we might want to do is to use floating- 
point numbers. These are numbers with a decimal 
point. These have a different type, called float. 

Try changing the code above so instead of: 


int a; 
.. you have: 
float a; 


This tells the compiler that a is now a floating-point 
value, rather than an integer. Compile and run your 
program. What happens? 

Oops! That doesn’t look right, does it? What has 
happened is that, while the maths is still all correct, 
the printf statement is now wrong, because you are 
telling it to print a, which is a floating-point value, 
as a decimal integer. To fix that, change the first %d 
in the printf function to %f, which is the format 
specifier for a floating-point number, like this: 


printf ("The result of adding %f and %d is 
’d\n", a, b, ©); 


That should produce something a lot more sensible 


when you run it. This is an important lesson about C: 
it will do exactly what you tell it to, even if it makes no 
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sense. You told it to show you a floating-point number 
as if it were a decimal integer, and the compiler 
assumed that was what you wanted, even though 

the result was nonsense. 

When you are working with variables, always keep 
track of what values you are putting in what types, as 
it is easy to introduce errors by assuming a variable is 
of one type when it is actually another. One common 
error is to put the results of a calculation on floating- 
point values into an integer. 

Try this: make b a float as well (not forgetting to 
change its format specifier in the printf), but leave c 
as an int, and set the two floats to values with decimal 
points, like this: 


float a; 
float b = 3.641; 
int c; 


a = 2.897; 

c=at+b; 

printf ("The result of adding %f and %f is 
%d\n", a, b, c); 


Yov’ll see a result like: 


The result of adding 2.897000 to 3.641000 
is 6 


6? That’s not right! But it is exactly what you 
have asked for. What the compiler did was to add 
the two floating-point values together, and got 
the answer 6.538, but you then told the compiler to 
put that into c, an integer variable. So the compiler 
just threw away everything after the decimal point! If 
you change c toa float, and change the final %d to %f, 
you’ ll find it gives the correct answer. 

That gives you some idea about how C handles 
numbers, and how you can use it for arithmetic; in the 
next instalment we’ll look at how to use the results of 
calculations to make decisions. 


Above Don't 
forget to use %f 
instead of %d as 
the print specifier 
when changing 
the int values to 
float values in 
the example 


MULTIPLE 
DECLARATIONS 


You can 
declare 
multiple 
variables of 

the same type 
in one line, 
separated by 
commas. For 
the example 
here, instead of 
three separate 
int declarations, 
you could type 
int a, b = 
3 G; 

on one line. 


REMEMBER 
PRECEDENCE 


C obeys the 
common rules 
for operator 
precedence - 
soa =a+2 
* 3 evaluates 
the multiply 
first and then 
adds the 
result, 6, to a. 
You can use 
round brackets 
to change 
precedence - 
a = (a + 2) 
23 

gives 3a + 6. 
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> GP2YOA2YKOF 
IR distance sensor 


> LM339 
comparator 


> 26-way dual line 
pin header socket 


> 3x LEDs, coloured 
red, green & blue 


> 21x14-hole 


stripboard Try to beat the Olympic 50-metre freestyle record 
> 50mm length 
of angled ast year in The MagPi #35 (July 2015), we showed The idea is that an IR distance sensor is used to 
ssc you how to make a Pi Sprinting simulator, register imaginary swimming strokes, although the 
l where you ran on the spot, tapping foot sensors. optimum stroke to use is not a graceful front crawl. 
E Now, with Olympic fever about to grip the nation, we In order to complete a stroke, you need to register 
bring you a swimming simulator. We are going to use three readings of increasing distance; the best way 
some of the elements of the Pi Sprinter software, but to do this is to do a sort of doggy paddle in mid- 
introduce a new way of interacting with the Pi. air in front of the sensor. The setup has the added 


As you ‘swim’, the 
display shows an 
animated swimmer 


An infrared sensor is 
used to register strokes 
performed in mid-air 
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The finished swimming sensor interface 


advantage of being totally immune to the ravages of 
overenthusiastic kids, because there is nothing that 
they have to touch. 


The hardware 

The IR distance sensor we used is the GP2YOA2YKOF, 
which is the same type we used in The MagPi #44 
infinity mirror project. The method of converting 
the output into a digital reading is the same as 

well, only this time the resistor values have been 
altered to trigger the distances we need. There are 


Totally immune 
to the ravages of 
enthusiastic kids 


also three coloured LEDs that help you know when 

a stroke is being registered, so you don’t drift out 

of the line of the sensor. We built the sensor onto a 
piece of stripboard that plugs directly into the Pi’s 
GPIO header. We used a mixture of surface-mount 
and through-hole techniques, although you can 
make it all using through-hole parts if you prefer. 
The full schematic of this is shown in Fig 1 (overleaf), 
and the finished interface can be seen above. The 
construction details are in the step-by-step guide. 
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>STEP-01 

Prepare the board 

Cut out a piece of 21x14-hole stripboard and make 

the cuts in the tracks shown above. Note that the cuts 
between the GPIO header are not done at a hole, but 
between the holes. To do this, make a cut across the 
board with a scalpel and then make another one in 
parallel with the first, as close as you can. This second cut 
should be angled in a bit so you remove a sliver of copper. 
Drill two 3mm holes for the sensor mounting bracket. 
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Distance sensor 
Í 


5V 


GP2YOA2YKOF 
47uF 


GPIO7 


270R 470R 


RED 


GPIO 11 
300R 


270R 


GPIO 4 


270R 


BLUE 


5V 
O.1UF 
3KG iti m 
min, 13! GPIO 23 
13v | a- 1 <20cm 
| I I 
our 
| 
10v l oN 141 GPIO24 
8). <27cm 
'  LM339 
i 
I 
Dev a OA 11 GPIO25 
_ 5]. <34cm 


Graphics work 

The big difference between this project and the Pi 
Sprinter one is the graphical display, which is split 
into two parts: the swimmer and the background. 
We used the Pi sprinter as the starting point for 

the background and added both a textured water 
surface in place of the track, and some Olympic 
sculptures on the side of the outdoor pool. The 
problem with the water surface was that it didn’t 
wrap round well: there was a discontinuity at each 
end. This was solved by splitting the water surface 
graphic into two, left and right, and then swapping 
the sides over. This had the effect of putting the 
discontinuity in the middle of the frame, where it 
could be made to blend together using the clone and 
blur tools found in any photo-processing package. 
The swapping of left and right halves is easier using 
Photoshop: use the filter in Filters>other>over. The 
GIMP package can be used for an all-Pi graphics 
solution. A repeating pattern of red and yellow 
rectangles make up a lane divider for the bottom 

of the screen. 


>STEP-02 


Mounting the components 

Attach the GPIO plug and IC socket as shown below. 
Add the solid wire links, shown in black, and solder 
the resistors in place. Complete the wiring by using 
flexible wires where indicated. Prepare the sensor 
bracket by drilling 3mm holes on one side of the angle 
aluminium to match those in the stripboard, and in the 
other to match the sensor. 
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470R Pin 1 of Raspberry Pi GPIO 


N 


aN 


Signal i 
Sensor 

>STEP-03 The swimming figure was isolated frame by 
Wire up the track side frame from a swimming animation, and the 
Flip the board over and add the surface-mount resistors complete sequence for a full stroke is 24 frames 
and capacitors; through-hole parts can be substituted long. The figure had a water level line where the 
if you prefer. Use flexible wires to make the other colours changed slightly, as if seen underwater. 
connections. Mount the three LEDs and angle them by This was achieved by adding a blue tint to the 
about 45° towards the sensor; note here that the flat colours under this line. However, this still gave 
spot on the LED denotes the cathode, which is usually the impression that the swimmer was swimming 


the shortest leg. Fix the sensor to a bracket, attach the 


on top of the water. To get round this, the part of 
bracket to the board, and wire it up to the sensor. 


the figure under water was given a 66% opacity 
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value. This was done by creating two layers in the 
photo-editing package with the same contents. 

Then the out-of-water half was removed from one 
layer and the underwater half from the other. The 
underwater layer was then set to 66% opacity and the 
picture saved as a PNG file. This merges or flattens 
the image before storage. The upshot is that the 
lower half of the figure is translucent and you can see 
some of the water surface ripple through the lower 
part of the swimmer. However, in practice, thanks 

to the way the brain interprets images, this looks 
like you are seeing the swimmer through the water 


ripple. Fig 2 shows this effect halfway through a race. 


The software 

The software is shown in the swimmer.py listing. 
The background scrolls repeatedly as the swimmer 
makes their way from the left to the right of the 
screen. The action looks smooth as long as you 
keep paddling with your hands. The LEDs will light 
in the sequence red, green, blue as you make one 
stroke. The start sequence is like a swimming race, 


The sounds were 
pulled from a real 
race video 


with a whistle summoning the swimmers, then the 
instruction to ‘take your mark’, and finally a buzzer 
starting the race. The sounds were pulled from a real 
race video; we found the best races to use were the 
long ones, as they did not suffer from voice-over by 
commentators like the sprints did. All the sound and 
graphics files, along with the code, are on our GitHub 
repository (magpi.cc/1NgJjmV). 


Taking it further 

You could duplicate the distance sensor to make a 
side-by-side real-time race. Alternatively, using two 
sensors, you could detect a butterfly stroke. 


Fig 2 The screen halfway through a race 
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swimmer.py 


or 
02: 


import pygame, time, os, random 
import wiringpi2 as io 

pygame .init() # initialise graphics interface 
pygame.mixer.quit() 

pygame.mixer.init(frequency=22050, size=-16, channels=2, 
buffer=512) 


os.environ[ 'SDL_VIDEO_WINDOW_POS'] = ‘center’ 
pygame.display.set_caption("The Pi Olympic Swimmer") 
pygame.event.set_allowed(None) 
pygame.event.set_allowed([pygame.KEYDOWN, pygame.QUIT]) 
screen = pygame.display.set_mode([1000,415],0, 32) 
textHeight = 36 

font = pygame.font.Font(None, textHeight) 
random.seed() 


compPins = [ 8,25,24,23] 
ledPins = [ 7, 11, 4 ] 
restart = True ; strokeState = @ 


soundEffects = ["whistle","mark","go","end"] 
swimingFrames = [ pygame.image.load("images/ 
S"“+str(frame)+".png").convert_alpha() 

for frame in range(@,24)] 


background = pygame.image.load("images/BackgroundPi.png"). 


convert_alpha() 


gameSound = [ pygame.mixer.Sound("sounds/"+soundEffects[sou 


nd]+".ogg") 
for sound in range(@,4) ] 
def main(): 
global restart, strokeState 
initGPIO() 


print"The Pi Olympic Swimmer" 
while True: 


if restart: 
frame = @ ; distance = @ ; manDistance = -85 
posts = 3 ; ledOff() ; strokeState = ð 


restart = False ; showPicture(frame, distance, - 
400, posts) 
time.sleep(2.@) ; gameSound[@].play() 
print"Mount" ; time.sleep(4.0) 
showPicture(frame, distance,manDistance, posts) 
print"Take your mark" ; gameSound[1].play() 
time.sleep(random.randint(2,5)) 
print"Start" ; startTime = time.time() 
gameSound[2].play() 
strokeDetect() 
showPicture(frame,distance,manDistance, posts) 
manDistance += 4 
distance += 40 
if distance > 3000: 
distance -= 2000 
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OLYMPIC SWIMMING SIMULATOR 


posts -=1 
frame = frame + 1 
if frame > 23: 
frame = @ 
if posts == @ and distance >=100 : 
raceTime = int(100*(time.time() - startTime)) 
gameSound[3].play() 
drawWords("Finished "“+str(raceTime / 100.0)+" 
Seconds", 400, 258) 
pygame.display.update() 
print"Finished - type return for another race" 
while not restart: 
checkForEvent() 


def initGPIO(): 
try 
io.wiringPiSetupGpio() 
except : 
print"start IDLE with 'gksudo idle' from command 
line" 
os._exit(1) 
for pin in range (0,4): 
io.pinMode(compPins[pin],@) # mux pin to output 
io.pullUpDnControl(compPins[pin],2) # input enable 
pull up 
for pin in range (@,3): 
io.pinMode(ledPins[pin],1) # LED pin to output 
io.digitalwrite(ledPins[pin],®) 


def showPicture(frame, distance,manDistance, post): 
screen.blit(background, [-distance,0]) 
if distance > 1000 : 
screen.blit(background, [1999-distance,@]) 
drawWords(str(post), -distance+1932, 220) 
screen.blit(swimingFrames[ frame] , [60+manDistance, 230]) 
pygame.display.update() 


def drawWords(words,x,y) : 
textSurface = pygame.Surface((14,textHeight) ) 
textRect = textSurface.get_rect() 
textRect.left = x 
textRect.top = y 
pygame.draw.rect(screen, (102,204,255), 
(x,y,14, textHeight-10), @) 
textSurface = font.render(words, True, 
(255,255,255), (102,204,255)) 
screen.blit(textSurface, textRect) 


def strokeDetect(): 
global strokeState 
if strokeState == 0: 
while getSensor() != 1: 
checkForEvent() 
io.digitalwWrite(ledPins[2],0) 
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Tutorial 
qanguage 


>PYTHON 2.7 


DOWNLOAD: 
magpi.cc/1NqJjmV 


io.digitalWrite 


(ledPins[@],1) 

strokeState = 1 
nen PROJECT 

l VIDEOS 

if strokeState == 1: 
while getSensor() != 3 : Check out Mike's 

checkForEvent() Bakery videos at: 

K e : y magpi.cc/1NqJnTz 
io.digitalWrite(ledPi 


ns[@],@) 
io.digitalWrite(ledPins[1],1) 
strokeState = 2 
return 
if strokeState == 2: 
while getSensor() != 7: 
checkForEvent() 
io.digitalWrite(ledPins[1],0) 
io.digitalWrite(ledPins[2],1) 
strokeState = @ 
return 


def getSensor(): 
sensor = 0 
for i in range(@,4) : 
sensor = (sensor << 1) | 
io.digitalRead(compPins[i]) 
return sensor 


def ledOff(): 
for pin in range (0,3): 
io.digitalwWrite(ledPins[pin],0) # LED off 


def terminate(): # close down the program 
print "Closing down please wait" 
for pin in range (0,3): 
io.pinMode(ledPins[pin],@) # LED pin to input 
pygame.mixer.quit() 
pygame.quit() # close pygame 
os._exit(1) 
def checkForEvent(): # see if we need to quit 
global restart 
event = pygame.event.poll() 
if event.type == pygame.QUIT : 
terminate() 
if event.type == pygame.KEYDOWN : 
if event.key == pygame.K_ESCAPE : 
terminate() 
if event.key == pygame.K_RETURN : 
restart = True 


print"New Race" 


# Main program logic: 


if _name_ == '_ main_': 


main() 
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Tutorial 


Upload files 
quickly via the 
Terminal to your 
Dropbox account 


pe Edt syma gun goons poiss pep 


You can also add Dropbox 
capabilities to your 
Python scripts - perfect 
for photo projects 


piant = 
Mil (iiplosdi, sibe 1 


ace Mo 


View your Dropbox 
files online in 


E 


your browser, 

or on another PC 
with a synced 
Dropbox folder 


GET DROPBOX 
ON RASPBERRY PI 


Connect to the most ubiquitous cloud service on your Raspberry Pi, 
perfect for uploading pictures and video in a project! 


Dropbox account 
dropbox.com 


Dropbox 
Uploader 
magpi.cc/ 
2aaHoJN 


Your Dropbox 
API key 


ropbox’s relationship with Linux has always 

been slightly weird, and as Raspbian is a 

version of Linux, that too means it’s not so 
straightforward to get the file-syncing behaviour of 
Dropbox to work. There are definitely ways around this, 


though, and with a little bit of hacking and tweaking, 


we can get auto 
to Dropbox. Thi 


matic uploads (and d 
s method was create 


ownloads!) of items 
d by Alex Eames of 


RasPi.TV and is perfect for many types of Raspberry Pi 


project, especially those where you 
and want to view them remotely or 


2) 


re taking pictures 


free up some space 


on the Raspberry Pi after they’ve been taken. 


>STEP-01 


Get a Dropbox account 
If you don’t already have one, sign up for a Dropbox 
account at dropbox.com. It offers a couple of GB for 
free, but you can pay a small amount a month for a 
whopping 1TB of space. There are some other cloud 
services around, such as Google Drive, but they have 
even less Linux support than Dropbox. As with most 
cloud storage services, you can view, download, 
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and upload files from the browser. So if you want 
to download anything to the Raspberry Pi, it can be 
quick and easy to go through there. 


>STEP-02 

Get Dropbox uploader 

Now we need to grab Dropbox Uploader on the 
Raspberry Pi. Boot into Raspbian if you’re not already 
using it, and either open a Terminal or SSH into the 
Raspberry Pi if you prefer. From there, you’ll need to 
download the install files with: 


github. com/andreafabrizi/Dropbox-Uploader. git 

Once that’s downloaded, you’ll need to move to the 
folder (cd Dropbox-Uploader) to begin installing. 
You can start this off with: 


./dropbox_uploader.sh 


It will ask for your API key, which is our cue to move 
onto to the next step. 
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>STEP-03 

Find your API key 

You need to head to the developers’ section of 
Dropbox (magpi.cc/2aaQnKQ) so you can create a new 
app and get a unique API key to use on the Raspberry 
Pi. Click on Create App to start. 

As we’re working towards a personal use application, 
the first option we’ll chose is Dropbox API rather than 
business. The next two options don’t really matter: if 
you want to access full Dropbox, you can, but it may 

be better for privacy and security reasons if you’ re just 
able to use a specific folder on your Dropbox. Finally, 
name it whatever you want and click Create App. 


>STEP-04 

Enter your API key 

On the settings page for the app you created, there 
will be an ‘App key’ field. Note it down or simply copy 
and paste it in into the Terminal if you’re still on your 
Raspberry Pi. It will then ask for the ‘App secret’, 
which is right below the key in your settings page. 
Click on ‘show’ and then enter that. It will then ask 
you to confirm what type of permission you gave it 
(full or just a folder) and then it will drop a link to put 
in the browser to confirm everything. Press ENTER to 
finish the setup and if everything has gone correctly, 
it will flash up a message to let you know! 


>STEP-05 

Add a progress bar 

Without a progress bar, you won’t always know if 
everything is working. Luckily, you can add one to 
this project: open up the installed file we just used 
(nano dropbox_uploader.sh) and look for the line 
that says SHOW_PROGRESSBAR under Default values. 
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GET DROPBOX ON RASPBERRY PI 


File Edit Tabs Help 


Tutorial 


FREEING 
UP SPACE 


In a Bash or 
Python script 
using the 


function, you 
can always set 
it to delete the 
upload once 
it's sent, to 
free up space 
on the Pi. 


Left Creating an 
app on Dropbox 
is easy; just make 


sure it has a unique 


name so you can 
get it working 


If this line ends with =@, then change the @ to a1 and 
save the file. There are also some other options under 
Default values (such as the ability to skip existing 
files), so have a quick look and see if there’s anything 
else you feel confident to change. 


>STEP-06 

Start uploading! 

Now everything should be working and you can 

start uploading. Everything revolves around the 
dropbox_uploader file, so stay in the folder or make 
sure to have your code point towards the folder in the 
future. The code to upload is something like: 


./dropbox_uploader.sh upload path/to/file 
dropbox_filename 


You can use this code in Python 3 by creating an OS 
call, using something like: 


from subprocess import call 

Upload = "home/pi/Dropbox_Uploader/ 
dropbox_uploader.sh upload path/to/file 
dropbox_filename" 

call ([Upload], shell=True) 


Time to get uploading and experimenting! 


Above From the 
Terminal, all 

you need to do 

is download the 
project to begin 
with: it's just a 
simple git request 


OTHER 


COMMANDS 


As wellas 
uploading, you 


can use it to 
download files. 
A full list of 
commands is 
at: magpi.cc/ 
2aaHoJN 
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Tutorial 


WA 


I))) Sonic Pi 


AMPLITUDE MODULATION 


Learn how to master Sonic Pi’s powerful slicing capabilities with its creator, Sam Aaron.... 


Raspberry Pi 
running Raspbian 


Sonic Pi v2.7+ 


Speakers or 
headphones with 
a 3.5mm jack 


Update Sonic Pi: 
sudo apt-get 
update && sudo 
apt-get install 
sonic-pi 


his month, we take a deep dive into one of 
Sonic Pi’s most powerful and flexible audio 
FX - the : slicer. First, listen to the deep 
growl of this code, which triggers the :prophet synth: 


synth :prophet, note: :e1, release: 8, cutoff: 70 
synth :prophet, note: :e1 + 4, release: 8, cutoff: 80 


Now, let’s pipe it through the : slicer FX: 


with_fx :slicer do 
synth :prophet, note: :e1, release: 8, cutoff: 70 
synth :prophet, note: :e1 + 4, release: 8, cutoff: 80 
end 


Hear how the : slicer acts like it’s muting and 
unmuting the audio with a regular beat. It also affects 
all the audio generated between the do/end blocks. 
You can control the speed which it turns the audio 
on and off with the phase: (phase duration) opt. Its 
default value is 0.25, which means 4 times a second at 
the default BPM of 60. Let’s make it faster: 


with_fx :slicer, phase: @.125 do 
synth :prophet, note: :e1, release: 8, cutoff: 70 
synth :prophet, note: :e1 + 4, release: 8, cutoff: 80 
end 


Now, have a play with different phase: durations. 
Good values to try are 0.125, 0.25, 0.5, and 1. Fig 1 
shows how different phase: values alter the number 
of amplitude changes per beat. 

By default, the :slicer FX uses a square wave to 
manipulate the amplitude through time. Other control 
waves supported by :slicer are saw, triangle, and 
(co)sine — see Fig 2. The following code uses (co)sine 
as the control wave. Hear how the sound doesn’t turn 
on/off abruptly, but instead smoothly fades in/out: 


with_fx :slicer, phase: @.5, wave: 3 do 
synth :dsaw, note: :e3, release: 8, cutoff: 120 
synth :dsaw, note: :e2, release: 8, cutoff: 100 
end 
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<-> <> Ml 
Fig beat 1 beat 2 beat 3 
Play around with the different wave forms by 
changing the wave: opt to @ for saw, 1 for square, 2 for 
triangle, and 3 for sine. See how different waves sound 
with different phase: opts, too. Each wave can be 
inverted vertically using the invert_wave: opt. The 
control wave can also be started at different points 
with the phase_offset: opt — a value between @ and 
1. By playing with phase:, wave: , invert_wave:, and 
phase_offset opts, you can dramatically change how 
the amplitude is modified through time. 

By default, :slicer switches between amplitude 
values 1 (fully loud) and @ (silent). This can be altered 
with the amp_min: and amp_max: opts. Use this with 
the sine wave setting to create a simple tremolo effect: 


with_fx :slicer, amp_min: @.25, amp_max: 0.75, 
wave: 3, phase: @.25 do 

synth :saw, release: 8 
end 


This is like moving your hi-fi’s volume knob up and 
down just a little so the sound ‘wobbles’ in and out. 
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One of :slicer’s powerful features is its ability to 
use probability to choose whether or not to turn the 
slicer on or off. Before the :slicer FX starts anew 
phase, it rolls a dice and, based on the result, either 
uses the selected control wave or keeps the amplitude 
off. Let’s take a listen: 


with_fx :slicer, phase: 0.125, probability: @.6 do 
synth :tb3@3, note: :e1, cutoff_attack: 8, release: 8 
synth :tb3@3, note: :e2, cutoff_attack: 4, release: 8 


synth :tb3@3, note: :e3, cutoff_attack: 2, release: 8 


end 


We now have an interesting rhythm of pulses. Try 
changing the probability: opt to a different value 
between @ and 1. Values closer to @ will have more 
space between each sound, due to the likelihood of the 
sound being triggered being much lower. 

Another thing to notice is that the probability 
system in the FX is just like the randomisation system 
accessible via fns such as rand and shuffle. They are 
both completely deterministic. This means that each 
time you hit Run, you’ll hear exactly the same rhythm 
of pulses for a given probability. If you would like to 
change things around, you can use the seed: opt to 
select a different starting seed. This works exactly 
the same as use_random_seed, but only affects that 
particular FX. 

Finally, you can change the ‘resting’ position of the 
control wave when the probability test fails, from @ to 
any other position, with the prob_pos: opt: 


with_fx :slicer, phase: 0.125, probability: 0.6, 
prob_pos: 1 do 
synth :tb3@3, note: :e1, cutoff_attack: 8, release: 8 
synth :tb3@3, note: :e2, cutoff_attack: 4, release: 8 
synth :tb3@3, note: :e3, cutoff_attack: 2, release: 8 
end 


One really fun thing to do is to use :slicer to chop 
a drum beat in and out: 


with_fx :slicer, phase: @.125 do 
sample :loop_mika 
end 


This allows us to take any sample and create 
new rhythmical possibilities, which is a lot of fun. 
However, one thing to be careful about is to make sure 
that the tempo of the sample matches the current 
BPM in Sonic Pi, otherwise the slicing will sound 
totally off. For example, try swapping : loop_mika 
with the : loop_amen sample to hear how bad this can 
sound when the tempos don’t align. 

As we have already seen, changing the default BPM 
with use_bpm will make all the sleep times and synth 
envelope durations grow or shrink to match the beat. 
The :slicer FX honours this too, as the phase: opt 
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Tutorial 


AMPLITUDE MODULATION 


Saw 
wave: @ 
Pulse 
wave: 1 
Triangle 
wave: 2 
(Co)sine 
wave: 3 


me <«___—_— + 


Fig2 phase 1  phase2 phase3 


is actually measured in beats, not seconds. We can 
therefore fix the issue with :loop_amen above by 
changing the BPM to match the sample: 


use_sample_bpm :loop_amen 

with_fx :slicer, phase: @.125 do 
sample :loop_amen 

end 


Now, let’s apply all these ideas into a final example 
that only uses the :slicer FX to create an interesting 
combination. Go ahead, start changing it and make it 
into your own piece! 


live_loop :dark_mist do 
co = (line 70, 130, steps: 8).tick 
with_fx :slicer, probability: 0.7, prob_pos: 


1 do 
synth :prophet, note: :e1, release: 8, 
cutoff: co 
end 
with_fx :slicer, phase: [@.125, @.25].choose 
do 
sample :guit_em9, rate: @.5 
end 
sleep 8 
end 


live_loop :crashing waves do 
with_fx :slicer, wave: @, phase: @.25 do 
sample :loop_ mika, rate: 0.5 
end 
sleep 16 
end 


August 2016 MägPi | 57 


Tutorial 


A mouse 


Art assets - 
magpi.cc/ 
scratch_art 


Speaker 
(optional) 


This tutorial 
was adapted 


from a Code 


Club project 
(codeclub 
projects.org) 
and you can 
find more in 
Learn to Code 
with Scratch: 
magpi.cc/ 
Scratch-book 


MAKE A 


The boat crashes 
if it hits something 
brown, like this 
revolving gate 


The boat sprite is 
programmed to 
move towards the 
mouse pointer 


The timer is shown 
on screen, and 
stops when the 
boat reaches the 
yellow beach 


BOAT RACE GAME 
IN SCRATCH 


Create your own boat race game, complete with mouse control, 
collision detection, and on-screen timer 


n this tutorial, you’ll be making your own 
arcade game in which the player attempts to 
guide a boat safely around a maze-like course, 
including a revolving gate, and get to the finish in as 
fast a time as possible. You can even design your own 
custom course if you like. As well as moving a sprite 
towards the mouse pointer, this project involves 
collision detection, using the touching color 
Sensing block to determine whether the boat has 

hit something. Let’s dive in and start coding... 


>STEP-01 

Prepare your artwork 

First, delete the cat! You should then import the 

two sprites for the boat and gate. Since they’re not 

in the Scratch 1.4 library, you can download them 
(magpi.cc/scratch_art). Just click the star/folder icon 
above the Sprite List (bottom-right), then navigate to 
the folder where you’ve stored the downloaded graphics 
for this project. Import the Boat and Gate sprites. If 
you aren’t designing your own course, you can also 
download and import our Course backdrop: click Stage 
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in the Sprite List, select the Backgrounds tab (top- 
middle), then click Import and navigate to the folder. 


>STEP-02 

Design a course 

You could just edit our course. Alternatively, to create a 
brand new one, click on the Stage in the Sprite List, then 
the Backgrounds tab, and Paint. Use the paint bucket 
tool to fill the canvas with a blue colour for the water. 
Then use a brown colour, which should be the same as 
in the Gate sprite, to draw the walls of the course. Use a 
yellow colour to draw some sand for the finish. Finally, 
add some white arrows which will act as speed boosters. 
Once this is done, let’s make our Gate sprite rotate by 
adding the simple code in Listing 1 to its Scripts area. 


>STEP-03 

Controlling the boat 

In this game we’ll be controlling the boat with a 
mouse, using the code in Listing 2 in the Scripts tab of 
the Boat sprite. To do this, we simply point it towards 
‘mouse pointer’ and move it one step at a time, within 
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BOATRACEGAME Tutorial 


DUD File Edt Share Help 


when clicked 


forever 


turn Q É$ degrees 


when clicked 


switch to costume ‘normal 


point in direction ha 


Above: We used touching color Sensing blocks to 
detect when the boat has hit a hazard, booster, or the finish 


forever 
a forever loop. To stop it from moving when near if distance to mouse-pointer 
the pointer, we put the control code in an if block 
that only tells it to move if the distance to the pointer point towards |mouse-pointer 
is greater than 5. Run the code and guide the boat: ~ ——— 


at the moment, it sails straight through barriers. Move a steps 


>STEP-04 


Make it crash! 
What we need is some collision detection to check z - .03 | 
if touching color ? 


whether the boat has hit a hazard. Within your 


forever block, add the code from Listing 3 under your switch to costume hit 
boat control code. Here, we use the touching color 

Sensing block to see if the boat has hit anything brown: say for ah Secs 
click the colour square to get a dropper tool, then click switch to costume) normal 
on a brown part of the course. When it crashes, we 


switch the boat’s costume, say ‘Noooooo!’, then place point in direction ($9 
it back at the start point in its normal costume. 
Let’s add two more if touching color blocks, 
shown in Listing 4, to our forever loop. The first 
checks whether the boat has reached the yellow .04 


beach, which acts as the finish line, and stops the 
program. The second detects the white of our booster 


arrows and moves the boat three steps. say MZN for E$ secs 


>STEP-05 stop all 


Boosters and time 


if touching color W? 


To make our game a bit more exciting, we need a if touching color W? 
timer. Click the Stage and add the Listing 5 code to its 

Scripts area. This sets the time to zero at the start of move É} steps 

the game, then gradually increases the time variable 


in line with real time; you’ ll need to create the latter 
in Variables, and make sure it’s ticked so that it’s .05 | 
shown on the stage. A A 
>STEP-06 set time |to (i) 
Taking it further 
. forever 
You could easily add a sound effect for when the boat 
crashes, using a Sound block. You could even add wait (¥} secs 
background music, composing it using Sound blocks change time | by (0.1) 


with various drums, instruments, and notes. The best 
time(s) could also be stored in a variable or list. 
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Ada's Poetry Generator 


by the moon 


i 


st ah m MIS = 
wa E 


= 
= 
= 
=a 
== 
i| 

J. 


The poem is 
generated by 
selecting random 
words from lists 


When the computer 
is clicked, it beeps 
and shakes 


The user clicks on 
Ada Lovelace to 
start talking to her 


ADA POETRY 
GENERATOR 


Ada Lovelace unveils the Analytical Engine in Scratch! This early 
computer looks a bit primitive, but can generate random poems 


Art assets - 
magpi.cc/ 
scratch_art 


Alist of words 


An eye for poetry 


This tutorial 


was adapted 
from a Code 
Club project 
(codeclub 
projects.org) 
and you can 
find more in 
Learn to Code 
with Scratch: 
magpi.cc/ 
Scratch-book 


n this Scratch project, the user first chats 

to Ada, before clicking on her computer to 
generate a random poem. To achieve this, 
we’ll be creating and using lists, found in the Variables 
block category, containing words of a certain type: 
verbs, nouns, adjectives, and adverbs. We’ll then 
select randomly from these lists to create the poem, 
which should be different each time. They can 

be quite amusing. 


>STEP-01 

Prepare your artwork 

After deleting the cat sprite as usual, you need to 
import the sprites and backdrop. Since they’re not 
in the Scratch 1.4 library, you can download them 
(magpi.cc/scratch_art). As the Poetry backdrop is so 
simple - just a grey stripe at the bottom of a white 
canvas — you could paint it yourself, or just use ours by 
importing it from the folder where you’ve stored the 
downloaded graphics for this project. The same goes 
for the Banner sprite. Otherwise, import each sprite 
as usual, by clicking the star/folder icon above the 
Sprite List. 
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>STEP-02 

Ada says hello 

irst, we’ll get our Ada sprite to interact with the user 
via speech bubbles and text input when clicked, using 
the say and ask commands. Open the Ada sprite’s 
Scripts tab and then type in the code from Listing 1. 
ote that you’ll first need to create a name variable: 
elect the Variables block category from the top-left, 
hen click ‘Make a variable’, ‘For this sprite only’, 

nd enter ‘name’ in the text field. You should untick 
he name block to stop it showing on the stage. We 

an now set name to answer (the user’s text input), 

nd then add it into Ada’s response by using the join 
Operator block. Make sure you put a space after ‘Hi’ 
to avoid it being joined together with the name. After 
this, we add a block to get Ada to tell the user to click 
the computer. 


>STEP-03 

Computer beeps 

Click the Computer sprite and select its Scripts tab. 
This is where we’ll add the workings of our poetry 
generator. To start with, type in the code from 


z3! 


+o tn 


ov a 
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ADA POETRY GENERATOR Tutorial 


Cyw S AD 


Motion Control 


File Edit Share Help 


pub 


Looks Sensing 
Sound Operators 


"Variables 


say CAIN for Ø secs 


Pie What's your nama? EUSES 


say joinEH name) for @ secs 
BE Click the computer to generate a poem. rug 2 Jers 


: The script for Ada asks for the user's name, then says hi 
before telling them to click on the computer for a poem 


Listing 2. After a block to say ‘Here is your poem’ and 
the user’s name, we’ll use a Sound block to make our 
computer beep. Our Computer sprite already has the 
sound for this, or you can record/import a new one in 
its Sounds tab. We also add a repeat loop with two 
turn blocks to make the computer shake. 


>STEP-04 

Create word lists 

You can’t make a poem without words. We’ll store 
ours in four lists: verbs, adverbs, nouns, and 
adjectives. Create each of these in Variables by 
clicking the ‘Make a list’ button, then ‘For this sprite 
only’, and typing its name. It will then appear on 

the stage: to add words to it, click the ‘+’ icon and 
type them in, one by one. When done, untick this list 
block to make it vanish from the stage. We used the 
following words for our lists: 


Adjectives: happy, tired, hungry 
Adverbs: loudly, silently, endlessly 
Nouns: sea, moon, tree 

Verbs: laugh, dance, burp 


>STEP-05 

Poetry in motion 

Now we have our word lists, we can use them to generate 
arandom poem each time the computer is clicked by the 
user. Join the code from Listing 3 to the bottom of your 
existing script for the Computer sprite. It comprises four 
say blocks, each of which includes an item of Variables 
block; this should have ‘any’ selected from its drop- 
down menu, to make a random selection from the list. 
Test the project out a few times to check that it works 
properly and generates random poems. 


>STEP-06 

Taking it further 

While we’ve only created short lists for this example, 
you could add lots more words to them for greater 
variation in the random poems created by the 
computer. More, and differently constructed, say 
blocks can also be added to make poems longer. If 
yow’re not keen on blank verse, why not create lists 
of rhyming words? 
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e: To add words to each list, tick it to make 
it appear on the stage, then click its '+' icon 
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Tutorial STEP BY STEP 


An arcade isn't an arcade 
without the obligatory 
joystick! This one is perfect 


Our buttons include 
NeoPixels to add some 
pizzazz, but this is optional 


> Picade PCB 
(magpi.cc/ 
29DpDCz) 


> Zippy ball-top 
arcade stick 
(eBay) 


>2.8mm & 4.8mm 
arcade daisy 
chain wires 
(eBay) 


> Female A panel 
mount USB 
socket (eBay) 


> 8x 30mm 
arcade buttons 
(modmypi.com) 


> Various 12.7mm 
standoffs 


(modmypi.com) 


> 4x M4 
countersunk 
16mm machine 
screws and bolts 


> 3.5mm female- 
to-male stereo 
jack extension 


CONTROLS 


In this second part of the build, we’ll be showing you how 
to assemble your controls as part of your RaspCade home-build! 


rcade controls can be mind-boggling, 

especially with all the wires involved. It is 

no surprise that people get confused, but 
there’s no need to panic. The joystick and buttons 
are essentially switches with positive and negative 
terminals. Today we’ ll be going over wiring basics, 
and using Pimoroni’s Picade PCB as a brilliant way of 
setting up your RaspCade controls quickly and easily. 
If you haven’t already done so, buying dedicated 
arcade wiring looms or harnesses makes the whole 
process much easier because they are designed to be 
assembled quickly, without any soldering. Are you 
ready? Then let’s get started! 
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Self-taught Raspberry Pi enthusiast, 
founder of Raspberry Coulis, and 
guide writer for Pi Supply and Cyntech. 
raspberrycoulis.co.uk 
@RaspberryCoulis 


Plan your wiring first 

Before you put your controls in place, it is worth doing 

a test run first. Connect your wires and be sure you 
understand what goes where before placing them in 
your cabinet. The arcade wiring harnesses are perfect 
for this as the spade connectors simply slide on (and off) 
the buttons, so no soldering is required. Each button 
(including the joystick) has a positive and negative 
terminal. You can ‘daisy-chain’ the negative terminals 
(connect them together), which means you only have 
one ground wire instead of several. Once you’re happy, 
carefully press the buttons into place: they are a tight fit! 
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BUILD YOUR OWN ARCADE MACHINE | Tutorial 


3 (6 total) positive wires to 
individual inputs on PiCade PCBI 


Negative daisy-chain 
to ground on PiCade PCBI 


It's worth labelling your joystick when wiring. The switch is 
in the opposite direction, as it is activated when the joystick 
moves in that direction 


A Fritzing diagram showing how to wire 
up your arcade buttons, including the 
daisy-chain connection 


3 (6 total) positive wires to 
individual inputs on PiCade PCBI 


>STEP-02 

Bolt your joystick in place 

If you’re using our arcade cabinet design, the four 
holes should line up with the mounting plate on the 
joystick. Unscrew the ball-top and slide the plastic 
collar off, then bolt the joystick in place using four M4 
screws and bolts. You can use a countersink drill bit to 
tidy this up if you like, but it isn’t essential. Also, do 
not over-tighten the bolts as this could damage the 
cabinet. Once you have done this, replace the plastic 
collar and screw the ball-top back on. Now onto the 
wiring underneath... 


>STEP-03 

Better get yourself connected! 

Connecting your controls is not as difficult as you 
might think. Grab your 4.8mm arcade harness 

and slot one connector onto each negative (black) 
terminal. Daisy-chain these so you have one wire 
connecting the four negative terminals. Next, use 
some wire cutters to cut and strip the end so you have 
a wire that can be connected to the Picade. You may 
need to extend this wire, but this can be done easily, 
even by a soldering newbie. Next, connect one wire 
to each of the positive (red) terminals. Each of these 
will be connected to the Picade, too. 


~ 
. 


The Picade PCB is well worth the money. Button inputs are 
clearly labelled, which makes setting up your controls a breeze! 
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>STEP-04 

Push the button 

Before wiring your buttons, carefully push them through 
the holes in the cabinet. They are a tight fit, so be gentle 
where you push to avoid snapping the cabinet. Once 
they are in, use the 2.8mm arcade harness and daisy- 
chain all the negative terminals (any can be used, but 
use the same one on each button) and strip the end 
again. Then connect one to each positive terminal so you 
end up with seven wires ready to connect to the Picade 
(six positive and one negative). We can now move onto 
the final two buttons on the front panel. 


>STEP-05 

Assembling the front panel 

The front panel consists of two arcade buttons, a USB 
port, and the headphone jack. The buttons pop into 
place the same way the others, and you also need 

to daisy-chain the negative terminals: you should 
have three wires (two positive and one negative). The 
USB port screws into place and the other end will be 
connected to our Pi. You can use this to connect a WiFi 
dongle, or a USB thumb drive to store all your games, 
making it simple to add more. The headphone jack 
screws into place, allowing you to play your RaspCade 
without disturbing everybody. 


>STEP-06 

Connecting to the Picade PCB 

Connecting all the wires is really simple thanks to 

the Picade PCB. This has several screw terminals, all 
nicely labelled for our arcade controls. Simply find the 
relevant terminal and then screw the wire into place. 
You should have eight wires for the buttons and four 
for the joystick, as well as three ground (negative) 
wires. It isn’t essential to put the wires in exactly the 
right place, so if your ‘up’ button is connected to the 
‘down’ terminal, it can still be configured once in 
RetroPie. The Picade simply connects to the Pi via USB 
and that’s it! 


TIN THE 
WIRE ENDS 


If the wires 
don't stay in 


the Picade 
PCB, tin their 
ends with 

a soldering 
iron to fatten 
them up. 


BE GENTLE 
WHEN 
ASSEMBLING! 


The buttons 
are a tight 


fit and the 
cabinet is 


relatively thin. 
Be gentle 
when pushing 
the buttons 
into place. 
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FREQUENTLY 
ASKED QUESTIONS 


Your technical hardware and software problems solved... 


YOUR QUESTIONS ANSWERED 


NEEDA 
PROBLEM 
SOLVED? 


Email magpi@raspberrypi.org or 
find us on raspberrypi.org/forums 
to feature in a future issue. 


ia 


RASPBERRY P1 [as 


CABLES 


Right The official 
power supply for 
the Raspberry Pi 
provides very 
consistent power 


Recommended power supplies 

If you want to use the Raspberry Pi to its fullest 
ability, with add-ons like the Camera Module, Sense 
HAT and suchlike, the official Raspberry Pi power 
supply provides enough juice to get it all working 
properly: magpi.cc/2a14pye 


Mobile phone charger 

The Raspberry Pi is powered by a micro USB cable, 
the same one used by most mobile phones. The 
recommended minimum power for a Raspberry Pi is 
2A (2.5A for a Pi 3), so check your charger to see if it 
will power it properly like the official power supply. 


USB cable 

For light operations, especially if you’re running the 
Pi in command-line mode, you can power a Raspberry 
Pi from a computer’s USB port. This isn’t really 
recommended, though, so if you start having issues 
you’ll need to upgrade to a proper power supply. 


~ 


» 
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HDMI 

The HDMI port is your best bet for 1080p video and 
digital audio out from the Raspberry Pi. It’s the easiest 
one to use and a lot of software is preconfigured to use 
that by default, such as Kodi, the media centre software. 


Audio out 

The 3.5mm jack can be used like the headphone port 
on music players, phones, and other PCs. However, 
you can also use it as an audio out to speakers that 
take auxiliary cables, or by using a 3.5mm-to- 
composite stereo output converter. 


Composite video 

On the Raspberry Pi A+, B+, 2, and 3, there isn’t an 
obvious composite video out. However, the 3.5mm 
jack also allows for analogue video out if you have the 
correct RCA converter cable to use it. The original Pi 
models have a dedicated composite out, and the Zero 
needs a port soldered to it. 


Ethernet port 

On most versions of the Raspberry Pi, there’s an 
Ethernet port next to the USB ports that you can use 
to connect to a wired network. In Raspbian, it will 
automatically connect to a network, although in rare 
cases you may need to specify an IP address for it. 


USB Ethernet 

The Raspberry Pi Model A, A+, and Zero don’t include 
an Ethernet port. However, many USB-connected 
Ethernet ports can be plugged in and used in the same 
way as the standard Ethernet on other Pi models. 


USB hubs with Ethernet 

These are a bit more interesting: USB hubs that also 
act as an Ethernet port, allowing you to connect all 
your USB devices to something like a Pi Zero, as well 
as keeping it hooked up to the wired network. 
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What displays can I use? 

Most Pi models have composite and HDMI outputs. So 

you can hook it up to an old analogue TV through the 

composite or a composite-to-SCART connector, or toa 

digital TV or to a DVI monitor (using a cheap, passive HDMI- 

to-DVI cable for DVI). The Pi Zero uses a mini HDMI port. 
There's no VGA support, but active adapters are 

available. Passive HDMI-to-VGA cables won't work 

with the Raspberry Pi. When purchasing an active VGA 

adapter, make sure it comes with an external power 

supply. HDMI-to-VGA adapters without an external power 

supply often fail to work. 


Why is there no VGA support? 

The chip we use supports HDMI and composite outputs, 
but doesn't support VGA. VGA is considered to be an end- 
of-life technology, so supporting it doesn’t fit with our 
plans at the moment. However, if you really want to use a 
VGA monitor with a Raspberry Pi, then it is possible using 
an HDMI-to-VGA adapter. 


Does the HDMI support CEC? 

Yes, the HDMI port on the Raspberry Pi supports the CEC 
standard. CEC may be called something else by your 
TV's manufacturer; check the Wikipedia entry on CEC 
for more information. 


Can | add a touchscreen? 

The Foundation provides a 7-inch capacitive touchscreen that 
utilises the Pi’s DSI port; the screen is available through the 
usual distributors. Alternatively, several third-party retailers 
offer a range of touchscreens for the Raspberry Pi. 


What codecs can it play? 

The Raspberry Pi can encode (record) and decode (play) 
H.264 (MP4/MKYV) out of the box. There are also two 
additional codecs you can purchase through the Swag Store: 
MPEG-2, a very popular and widely used format to encode 
DVDs, video camera recordings, TV, and many others; and 
VC-1, a Microsoft format found in Blu-ray discs, Windows 
Media, Slingbox, and HD-DVDs. 


Having trouble with The MagPi on the App Store or Google Play? 


Here are your most common questions answered: 


How do I find The MagPi on Google Play 
or the App Store? 

Allyou have to do is go to the search bar and type ‘The MagPi’ 
or ‘Raspberry Pi’ to find us. 


I've subscribed to the digital edition and I can't sign 
in to restore my purchases. Please help! 


Since your The MagPi purchases are linked to your Google or Apple 
accounts, there's no need to sign in at all. If you'd like to re-download 
your purchases on your current device, or make your purchases 
available on other devices, all you need to do is press ‘Subscribe’ 


on the home screen, then ‘Restore Purchases’ on the next screen. canon 


P> Google Play 


How can I search the digital magazine for keywords? 
Finding direct references is really easy with The MagPi app: all you 
have to do is tap the screen to get the app’s GUI to show, and then 4 Available on the 


press the small magnifying glass icon in the top-right corner of the € Ap p Sto re 
screen. Just type in your search term to find the relevant results. 
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FREE 


Subscribe in print for six or 12 months to receive this stunning free gift 


Subscribe today & receive: 
A free Pi Zero v1.3 (the latest model) 
A free Camera Module connector 
A free USB & HDMI cable bundle 

Delivered with your first issue! 


Other benefits: 


Save up to 25% on the price 

Free delivery to your door 
Exclusive Pi offers & discounts 

Get every issue first (before stores) 
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SUBSCRIPTION FORM 


YES! I’d like to subscribe to The MagPi magazine & save money 


a a 
: A f 2 
p r i C l n g This subscription is: E For me E A gift for someone Mag#48 


Ms 


Get six issues: ee a ee ee 


AQUOSS  ssssscsscsccscssssnansnasncaases aranan ARRERA ESEESE EE EREEREER STE EEEREN ERAT 


£30 (UK) e E E A e E ee A E E S 


£45 
Mmr] mrs miss msl] 
$69 a AS Oe A 


RAGTOSS EIO EEEE IEEE T A AEDA PLE EEA EE T A SITERE T OTE E EEE ETT, 


£50 (Rest of World) panie 


PAYMENT OPTIONS 


e : 
x Instruction to your bank or building o Di DE 
° 


Please fill in the form and send to: 
The MagPi, Select Publisher Services Ltd, Service user number 


{ 5 5 (UK) PO Box 6337, Bournemouth BH1 9EH 


Name and full postal address of your bank or building society: 


Daytime phon saiisine iiaa MODE 5 esaa in raae ia cesbesaaed R aa 


*If giving The MagPi as a gift, please complete both your own details (above) and the recipient’s (below). 


ee) 
w 
oo 
N 
N 
w 


To: The Manager Bank/building'sOciety isc. ciccssssccoicccsaeacisoonssssoessssaasceesdessvasneoacdestassases 


£80 a tasdistattnmnmeatergieaunmisnemince 


$2970 NY) E 


Nartie(s)'Of accOunthOlder(S): ernn ARE 


£90 (Rest of World) Branch sor code M] [E] 0) 0 E E Account number IO | | IL] | | 


Reference 


(Official use only) 


Instruction to your bank or building society 
Please pay Select Publisher Services Ltd Direct Debits from the account detailed in this instruction 
subject to the safeguards assured by the Direct Debit Guarantee. I understand that this instruction 


e 
e may remain with Select Publisher Services Ltd and, if so, details will be passed electronically to my 
e ree Issues: banibuilding society. 


Signature spicis ie isiin risian ienn Date / / 


| 
£ Di Debit) 
12 e 9 9 (UK) ( Irect e it ) | Banks and building societies may not accept Direct Debit instructions for some types of account. 
l 
S3 7 e 5 O (US ) ( qu arte rly) SUBSCRIPTION PRICING WHEN PAYING BY CHEQUE OR CREDIT/DEBIT CARD 


6 ISSUES UK £30 Europe £45 | lRest of World £50 


12 ISSUES UK £55 Europe £80 |_IRest of World £90 


How to subscribe: 


I enclose a cheque .. (made payable to Select Publisher Services Ltd) 


MasterCard Maestro Switch 


| 


(if s 


Card number | | O | L | IO | 


Expiry date Valid from hown) 


Issue number (if shown) Security number 


(last3 digits on the back of the card) 


Signature errereen rreren r reic ai EE EOE ene Date / / 


I would like my subscription to begin from issue .........cecceeeeeeeeeeeeeeeeeees (month + year) 


4 Available on the 
RETURN THIS FORM TO: 

MagPi Magazine Subscriptions, Select Publisher Services Ltd, PO Box 6337, 
Bournemouth BH1 9EH 


€ App Store 


Please tick this boxif you DO NOT want to receive any other information 
from Select Publisher Services Ltd. 


GET IT ON Please tick this boxif you DO NOT want to receive any other information 


, G | P| from other companies. 
00g e ay Please tick this box if you DO NOT want to subscribe to The MagPi newsletter. 
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SCRATCH OLYMPICS 2016 


Want to check your work? Go to: 
magpi.cc/ScratchOlympics 


he Olympics are upon us! That sporting 

spectacle of incredible skill, where the world’s 

finest athletes come together to represent 
their country and show the world just how hard the 
human body can be pushed. If you’re not an Olympic 
athlete, you can always watch it on TV, but if you want 
to take part in some way, we have a solution. 

Using Scratch — the Pi version or online editor, 
depending on the project — we can create our own 
Olympic games in the comfort of our own homes and 
maybe, just maybe, it can prepare you for one day 
training up to become an Olympic athlete yourself. 
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Find this resource and 
more like it on the Code 
Club projects website: 
codeclubprojects.org 


100 points 


© 


Let loose a few virtual arrows and fulfil your fantasy of being Robin Hood 


et’s start by creating an arrow that moves 

around the screen for this fun archery event. 

Note that since this project uses a block type 
not present in Scratch 1.4, you’ll need to work on it in 
the online Scratch editor; to open the resources, go to 
magpi.cc/29KO9S3 and follow this tutorial there. 

When your game starts, broadcast a message to 

shoot a new arrow. Once this message has been 
received, set the arrow’s position and size (Fig 1). 
Click the green flag to test your game; you should see 
your arrow get bigger and move to the bottom-left 
of the stage. 


go to x GED y: GED 


amp 


= 9 
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SCRATCH OLYMPICS 2016 feature 


02) 
EET Event Info 


Add the code circled in Fig 2 to your arrow so that it 
glides randomly around the stage forever. Then test 
your game again, and you should see your arrow move 
randomly around the stage. 


Shooting arrows 

Let’s code your arrow to shoot when you press the 
space bar (Fig 3). This will stop the other script, the 
one moving the arrow, when the key is pressed. Test 


When you press the space bar 
you should see your arrow get 
smaller, as 1f it's moving om 


your project again. This time, your arrow should stop 
moving when you press the space bar. 

Now we can animate your arrow by reducing its size, 
using a change size block inside a repeat loop. Test 
your game again. This time, when you press the space 
bar you should see your arrow get smaller, as if it’s 
moving towards the target. 


Arrow 


Once your arrow is at the target, you can tell 
the player how many points they’ve scored. For 
example, they could score 200 points for hitting 
the yellow. You can also play a sound if they hit 
that colour (Fig 4). 

Finally, you need to broadcast the new arrow 
message again to get a new arrow. 
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WEIGHTLIFTING 


Lift the heaviest thing you can to win big. Be careful with your keyboard! 


n this activity, you will make a game in Importing the assets into Scratch 

Scratch on the Pi that allows you to test your Open Scratch by clicking Menu > Programming 

keyboard-mashing skills. By repeatedly hitting > Scratch. Now click on the Stage icon and then 

the keyboard, the character will lift their barbell high drag and drop the Olympics background into the 

into the air. There will also be the opportunity to have Backgrounds tab. You can delete the original 

a play with some physical computing, and introduce background. Next, click on Sprite1 and then, one by 

some arcade-style buttons into the game. one, drag and drop the Weightlifter costumes into the 
For this project, you’re going to need a sprite anda Costumes tab. You can delete the original costumes. 

background. You can download a zip file containing all 

the game assets by going here: magpi.cc/29AVkj5. Testing the animation 
Once the file has been downloaded, you can unzip You can check whether the animation will work using 

the archive by right-clicking on it and choosing unzip. the simple script in Fig 1: 

You should see two directories: one containing the 

weightlifter’s costumes and the other containing 

the background. 


when clicked 
forever 
wait (F} secs 
Event Info [ next costume 
= 
NAME. Weightlifting 
UARIATIONS: Snatch, Clean and Jerk Click on the green flag and watch the weightlifter 
d 
do his thing! 

INTRODUCTION. 1896 
DESCRIPTION. Capturing the speed of key presses 
The ultimate test in strength, divided The progress the weightlifter makes is going to be 
by weight class to create a more equal controlled by the speed at which the player can hit the 
playing field Z and X keys, so you need to create some scripts that 


will capture this data. 
You’re going to need two variables in this game. 
The first, called progress, will be used to record how 
far into the lift the weightlifter has managed to get. 
The second, called last_key, will be used to store the 
last key press the player made. 
Create these two variables by clicking in Variables 
m and then clicking on Make a variable. Start your script 
E by setting progress to be 1 and last_key to be x when 
the game starts. The player must switch between 
hitting the X key and the Z key for the progress to 
increase. So when the X key is pressed, your script 
needs to check that the last key press was Z. If it was, 
then progress can be increased and the last_key 
can be switched to x. This is called conditional 
selection. The action only occurs if a variable 
is at the correct value (Fig 2): 
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when X key pressed 


if last_key = Ø 


by §3 


change progress 


to Ų 


set last_key 


Of course, you want the same sort of thing to 
happen when you press the Z key. You can duplicate 
the script by right-clicking on it and selecting 
duplicate from the context menu, then change the 
duplicated script to switch x for z and vice versa. 

Test that your game works by clicking on the green 
flag, and then repeatedly hitting the X and Z keys on 
the keyboard. You should see the variable progress 
increasing. The faster you hit the Keys, the faster it 
will increase. 


Making the character lift 

There are a total of 29 costumes in the game. 

The sprite’s costume can be continually set so that 
it’s the same as the progress variable. That way, 
as progress increases, the costume will change. 
When progress reaches 29, the game can end. 

You will need a forever loop for the main logic of 
the game. Find a forever loop in the Control section 
and add it to the bottom of the first/main script. Now 
place another conditional block within the forever 
loop; this time, you can use anif else block. If 
progress reaches 29 then the sprite willsay "I 
win", the costume is set back to costume 1, and the 
script is stopped. If 29 has not yet been reached, then 
the costume can be set to the same value as progress. 

You can’t directly set a costume to a specific number 
in Scratch, but you can use the round Operator block to 
set the costume to its number (Fig 3): 


when clicked 


to L 
to Ñ 


set progress 
set last_key 


forever 


if progress 29) 


stop script 
else 


= 
me progress 
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a a A a 


(E 


aam I Tat Ai- 


aes = lie 
TO 


Have a go at testing your script. Click the green flag 
and then start hitting the X and Z keys alternately to 
watch the weightlifter go. It’s a good idea to reset the 
costume back to number 1 each time the script starts: 


Making it a little trickier 

If you stop hitting the X and Z keys, then the 
weightlifter just stops lifting. It would be good 
if he started to put the weight back down if the 
player’s speed on the keyboard decreases. This 
can be done by decreasing the value of progress 
every once in a while. To start with, create a new 
variable and call it difficulty. This can be set to 
-1 in the main script. 

Grab a new when green flag clicked block and 
place it into the Scripts area. You can now use a 
forever if loop, which will run as long as a variable 
is at a certain value. You want it to run as long as 
progress is greater than 1 (Fig 4). 

Inside the forever if loop, you’ll need to keep 
changing progress by the value of difficulty. 

As difficulty is a negative number, this will keep 
reducing progress until it reaches 1. You’ll need to 
use a little wait command as well; since computers 
are so fast, there’s no way a player could keep up with 
the computer otherwise. Waiting for @.4 seconds will 
do to start with. 


when clicked 


foreverif progress > 


change Progress 


wart (X) secs 


by difficulty 


feature 
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Test your game to see the weightlifter pick up the 
weight as you hit the keys, but lower it again if you 
stop pressing them. 


Looping the animation 
Let’s make the game a little more interesting now. 
You can start off by using a little loop effect at the 
start of the game. Pay attention to this next part, as 
you'll be using the same techniques later on. 

The first four costumes can be looped to make the 
sprite look like he’s getting ready to start. You’ ll - — 
need to geta when I receive block. Click on the | switch to costume “round 


See the weightlifter pick up 
th : ht lal it th k If you click on this block, it should have a halo of 
S Welg as you | G CYS, white around it, and the sprite should start looping. 
. . . To finish this section off, the starting block needs 
but lower i ag aln if you stop to be triggered from within the main script (Fig 6) 
whenever progress is 1, 2, 3 or 4, or in other words, 
little black arrow and create a new broadcast called <5 and >@. If it is, then starting can be triggered and 
starting. The first thing that happens in starting the script can wait until progress is greater than 4. 
is a switch to the first costume. This is followed by a This all goes into the main script. 
repeat until block; you can make the code inside it 
run until the game begins. You’ ll know that the game 
has begun because progress will increase above 1. 
Use a > operator from Operators to help you build the [switch to costume (round) 
script (Fig 5). 

You can change the costume inside this loop. If 
the costume reaches number 4, then it needs to be 
reset back to costume 1 again. You’ll need a couple 
of wait blocks as well, so you can actually see 
the costume changing. 


say [RT for @ secs 
= switch to costume (Eun 
switch to costume (progress) 
| | | | 


Run your script and the weightlifter should glance 
left and right. When you start hitting the X and Z keys, 
he should start to lift. If you stop hitting the keys, 
he’ll return the weight to the floor and then start 
glancing left and right again. 


Adding in a strain stage 
You can adda second difficulty level by playing around 
with the timings and how they affect the costume; go 


etl gs to magpi.cc/29MuJPv to find out how to complete it! 
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HURDLES 


What’s more exciting and challenging than running on a track? 
Adding some obstacles to jump over! 


n this activity you will make a hurdles game 

using Scratch, where the speed of the runner 

is controlled by how fast you can hit the X and 

Z keys, and perfect timing is required to jump 
over the hurdles at exactly the right time. Download 
the zip file to your home directory and unzip its 
contents: magpi.cc/29NUFYk. 

Open Scratch by clicking on Menu > Programming 
> Scratch. Now, click on the background icon and 
import the new background from the assets directory. 
You can then delete the old background. 

Click on the icon to import a new sprite and then 
choose the run-1 image. Next, import run-2, run-3, 
and run-4 as additional costumes. You can then delete 
the old cat sprite. 


Capturing the key mashing 

The first step is to capture the X and Z key presses, 
and use the speed at which the player is pushing the 
keys to control the size of a variable. To do this you’ Il 
need a variable that stores the last known key press. 
Create a variable called last_key and set it to z when 
the green flag is clicked. 

For the next script you’ ll need a new variable called 
speed, so go ahead and create it now. It can be set to @ 
when the game begins (Fig 1). 

When the X key is pressed, if the last_key is equal 
to z, then the speed variable can be increased and 
the last_key can be set to x. This will ensure that the 
player can’t cheat and keep hitting the X key to make 
the speed increase. The same can be done for the Z 
key. In combination, these two scripts force the player 
to hit the keys alternately in order to increase the 
speed variable. 

Now test your script. Click the green flag, then 
repeatedly press the X and Z keys and watch the speed 
variable increase. 


Animating the hurdler 

At the moment, the hurdler has four costumes as 
part of what’s called a walk cycle (or run cycle in 
this case). When these costumes are switched, the 
character appears to run on the spot. The time delay 
between costume switches should depend on the 


NAME. Hurdles 


URRIATIONS. 100 metres, 
110 metres, 


400 metres 


INTRODUCTION. 1896 


DESCRIPTION. 

Get to the end of the course as fast as you 
can, but remember to jump over the hurdles 
in your way 


clicked 


-z | 
O o | 


when 
set last_key 


set speed 


when ẸJ key pressed 
if last key -H 


by © 
to 


change speed 
b 


set last_key 


when EJ key pressed 
if last key = E 


by © 
to -z | 


change speed 


last_key 


speed variable. The higher the speed, the quicker the 
costume change should be and therefore the smaller 
the delay. You can get this effect by dividing 1 by the 
speed variable to calculate a delay. 

If you run this script as it is, you’ ll get an error, 
because speed starts off with a value of @. This means 
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the computer is trying to calculate 1 / 0, which it can’t 
do. It’s avery common error that programmers make 
in their code. To fix this, you can use a conditional 
to make sure that the calculation only occurs when 
speed is larger than @ (Fig 2). 

02 


switch to costume run-1 


switch to costume run-2 


switch to costume run-3 
switch to costume run-4 


Now you should be able to test your script and watch 
the hurdler running on the spot as you press the X and 
Z keys. 


Get jumping 
Hurdlers need to jump. Youv’ll need a few more 
costumes for this part, so look in the runner directory 
and import the jump-1 and jump-2 costumes for your 
hurdler. Yov’ll need a new variable for this part called 
jumping. This is because other scripts will need to 
know when the character is jumping. Create the new 
variable on the green flag block and set it to False. 
The character should jump when the space bar is 
pressed. The first thing that happens is the jumping 
variable should be set to True, then the costume can 
be changed to jump-1 and the character 
can glide upwards. Next, the costume can 
be changed to jump-2 and the character 
can glide back down again. Finally, 
the jumping variable can be 
returned to False to indicate 
that the jumping animation 
has finished (Fig 3). 


switch to costume jump-1 


glide [XY secs to x: BU) y EA 


switch to costume jump-2 


glide [EJ secs to x: BW] y Ea 


v False 


Test your script; it might surprise you to see that the 
character’s costume doesn’t change. This is because 
the walk cycle you set up previously is still working. 
You’ll need to stop this walk cycle when the character 
is jumping. To do this, you can use an and conditional 
operator to check that both speed > @ and jumping 
= False for the walk cycle to work (Fig 4). 

-04 


when > 


—~ 


“speed > EJ and jumping = GED 


switch to costume run-2 
switch to costume run-3 


Now have a go and you should find your character 
jumps when the space bar is pressed. 


Slowing down 

At the moment, the more you press the X and Z keys, 
the faster the character runs. There needs to be a way 
of slowing the hurdler down, so she doesn’t win too 
easily. This can be done on your initial script that sets 
the starting variables. You just need to add an infinite 
loop that will check if the speed is greater than 1, and 
then lower it every few 100ths of a second (Fig 5). 


‘ton a | 
p = = 
r = o 
7 False 


4 
- 


Adding in hurdles 
For the final part of this tutorial, you can add in 
hurdles that the character will have to jump over. 
Import the hurdle.png sprite from the assets/items 
directory. This sprite needs to begin at the far right of 
the screen, then it should continually move left across 
the screen at a pace that’s proportional to the speed of 
the character. When it hits the far left of the screen, it 
should instantly appear on the right again (Fig 6). 
-05 


Making the hurdles an obstacle 
At the moment, the runner can just plough straight 
through the hurdles. She needs to be slowed down if 
she doesn’t jump. 

Back on the hurdler sprite, add in a new when 
green flag clicked block. This next part is a little 
complicated. The runner should be slowed down if she 
isn’t jumping, has an x position just before the hurdle, 
or has an x position just after the hurdle (Fig 7). 
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This can be achieved using two and logical operators, 
checking if jumping = False, that x position > x 
position of hurdle - 5, and x position < x position of 
hurdle + 5. If all those conditions are met, then she 
must have hit the hurdle and her speed can be dropped. 


Making an end to the game 

To finish off a completed game, you need to add 

in a finishing line. You can find one in the assets/ 
items directory. Import this as a new sprite into your 
Scratch game, and approximately position it into 

the runner’s lane. 

To start off, you need to use a variable to control 
how far the hurdler has to run. Create a new variable 
and call it distance. The first script to be added to 
the finish line will set distance to @ when the game 
begins, position the finish line to the far right of the 
screen, and hide it. Next, distance has to be increased 
by the speed of the runner every second (Fig 8). 


ju 


v o 


go to x: 220 y: -21| 


hide 


Find this 
resource 
and more 
like it on the 
Raspberry 
Pi resources 
website: 
magpi.cc/ 
1qEg9Nh 


Now that the finish line is ready to go, you can 
make it appear when the value of distance hits 
whatever value you desire (200 in this example). It 
can then begin to move across the screen towards the 
hurdler. When she touches the finish line, detected 
by touching color, all the game scripts should end - 
see magpi.cc/29WZVof. | 
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oY NCHRONISED 
SHIMMING 


Swim to the beat and wow the judges with your stylish water moves 


when left arrow 


when left arrow 


switch costume to left J 
turn F) € degrees 
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key pressed 


turn F) €B degrees 


kev pressed 


NAME: 
UARIATIONS. 
INTRODUCTION. 


Synchronised swimming 


Team, Duet 


1984 Summer Olympics, 
Los Angeles, USA 

DESCRIPTION. 

Originally known as water ballet, it 

involves team of swimmers performing 

a coordinated routine to music 


when 


move €f steps 


up arrow key pressed 


when right arrow key pressed 


turn (4 €B degrees 


when down arrow 


move @f) steps 


key pressed 


when up arrow key pressed 


move €f steps 


when right arrow key pressed 


Jf switen costume to night J 


turn C4 € degrees 


when down arrow key pressed 


move steps 


et’s start by getting one cat swimming. Note 
that since this project uses a block type not 
present in Scratch 1.4, you’ll need to work on it 
in the online Scratch editor. First, let’s turn the stage 
blue, like a swimming pool. Click on Stage, then the 
Backdrops tab. Choose a blue colour from the palette; 
click the ‘Fill with color’ tool, then click the backdrop. 

You’re going to use a different cat sprite, so right- 
click on the walking cat to delete it. Now click ‘Choose 
sprite from library’, select Animals, choose Cat1 
Flying and click OK. 

Now let’s get the cat swimming. Click on the Cat1 
flying sprite, then Scripts, and add code to make the 
cat rotate left and right when you press the left and 
right arrow keys (Fig 1). Test your code by pressing 
the left and right arrow keys on the keyboard, and add 
forward and backward movement. Test your code by 
swimming around the stage using the arrow keys. 


Changing costume 

This would look better if the cat sprite changed 
direction when it turns left. Click on Costumes 

and delete the cat1 flying-a costume. Rename the 
remaining costume from cat1 flying-b to right. 
Right-click on the costume and choose duplicate to 
create a copy, then click the ‘Flip left-right’ icon to 
reverse the copy and name it left. 

Click Scripts to return to your code and add blocks 
to change the costume when the direction is changed 
(Fig 2). Test your code by swimming around the stage 
using the arrow keys. 


Create the team 

Synchronised swimming needs more than one cat! 
We can use create clone of to make copies of the 
cat sprite that behave in the same way. First, let’s 
add code to make sure the cat always starts in the 
same position when you click the green flag (Fig 3). 
Test your code by pressing some arrow keys and then 
clicking the green flag to return to the start position. 
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when clicked 


go to x: O y: O 


point in direction € 


turn (A ŒJ degrees 
h 


create clone of myself 


(s 


Now we can use a repeat loop to create six clones 
(copies) of the cat. Loops are used to do the same 
thing multiple times. You don’t want all the cats to be 
in the same position, though, so add code to rotate 60 
degrees before creating each clone. 

Test your code by using the arrow keys. You 
should be able to create some amazing synchronised 
swimming patterns! 


when clicked 


forever 


7 


play sound dance around until done 


Music! 

A synchronised swimming routine needs music. (But 
if you can’t play sound then you can skip this step.) 
Click on the Sounds tab and then click ‘Choose new 
sound from library’. Select Music Loops, choose some 
music, and click OK. Then go back to Scripts and add 
the blocks to play your music (Fig 4). 
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Find this resource and 


more like it on the Code 
Club projects website: 
magpi.cc/29KATgh 


Putting the play sound block inside a forever loop 
means the music will keep repeating. You can now 
test your project again; remember, you can click on 
the red stop button to stop the music playing! 


Programmed routines 

Would you like to be able to perfect a routine 

and easily repeat it? Let’s add some moves to be 
performed when the space bar is pressed (Fig 5). 
Run your project and press the space bar to test 
the new routine. Try using the arrow keys to move 
to a different position before pressing space. 


when space key pressed 


switch costume to night 
repeat €B 
“turn CA @ degrees 
move €% steps 
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CAMDEN 
BOSS 
ENCLOSURE 


This mini, wall- 
mountable 
acrylic case 
will protect just 
the Camera 
Module, not 
the Pi, and isn't 
weatherproof. 


magpi.cc/29HsnhO 


WILDLIFE CAM KIT 


WILDLIFE 


Capture wildlife photos with this weatherproof, Pi- powered camera trap 


ver wondered what kind of 

critters visit your garden 

whenever you’re not around 
to scare them off? With the Wildlife 
Cam Kit, you can find out. Its PIR 
sensor will sense any movement in 
the vicinity and trigger its Pi Camera 
Module to take a stealthy snap of 
whatever’s passing by. 

You may recall that we’ve 
followed the progress of this 
Kickstarter-funded project in 
previous issues of The MagPi, but 
now it’s finally out in the wild. 
Designed by Naturebytes, a trio 
of digital makers and wildlife 
enthusiasts, its aim is to give 
users a fascinating insight into the 
natural world while also enhancing 
their digital making skills. To this 
end, it comes in kit form, although 
no soldering is required. It takes 
an hour or so to put together, 
following the detailed online PDF 
instructions (magpi.cc/29HamiP). 
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The latter are well-illustrated with 
plenty of photos, even if a couple 
were slightly misleading. 


Constructing your camera 
A laser-cut plastic insert is 
provided to suit whichever 
Raspberry Pi model you’ re using; 
the standard kit comes with an A+ 
due to its lower power usage, but 
it could even be used with a new 
Pi Zero v1.3. Screws and plastic 
spacers are supplied to fit most of 
the components ~- including PIR 
sensor, Camera Module, and Pi - 
to the insert, threading jumper 
wires through its strategically 
placed holes. It’s clear that much 
thought has gone into its design; 
you even get bendy ties to push 
through pairs of holes to secure 
the wires tidily. Still, it wasn’t 

so easy to fit the jumper wires to 
the Pi’s GPIO pins through the 
large cut-out, requiring a small 


screwdriver to push them into 
place. A real-time clock module is 
also fitted to five of the pins (since 
the Pi doesn’t have one built-in), 
to enable accurate date/time- 
stamping of photos without an 
internet connection. 

Finally, an Adafruit Powerboost 
is fitted to the insert and connected 
to a LiPo battery. This is to boost 
the latter’s 3.7V output to the 5.2V 
needed to power the Pi and other 
components. A power switch has 
been added to the Powerboost to 
make it easier to switch the camera 
on and off when outdoors. Before 
you can use it, however, you’ll need 
to charge up the battery, which 
takes around 17.5 hours; it might be 
advisable to start doing this before 
assembling the rest of the kit. 
Naturebytes claims it will provide 
around 30 hours of power; in our 
tests it lasted up to three days 
between charges. 
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Testing it out 

Before positioning the camera 
trap outdoors, it’s a good idea 

to hook it up to a TV to check 
everything’s working properly. 
The supplied SD card features 

a customised version of the 
Raspbian operating system, 
featuring a Naturebytes logo 
and desktop shortcuts for various 
tools, including PIR and camera 
tests. The main Python script for 
taking photos can also be tweaked. 
By default, it adds graphical 
overlays — a date/time stamp 
and Naturebytes logo — to each 
photo taken. However, we found 
that this was causing a lengthy 
delay (of up to two minutes) 
when writing to the supplied 

USB stick, possibly caused by 

a lack of RAM in the 256MB Pi 

to handle the I/O process. 
Naturally, this is undesirable 
when capturing wildlife photos, 
the critter may have vanished 
the meantime. Fortunately, 
commenting out the code lines 
for the overlays solved the 
problem. Writing to an SD card 
is even quicker, although it’s 

far more convenient to simply 
remove the USB stick and plug 
it into another PC in the house 
to view the photos, without 
having to bring the whole 

device back inside. 
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Venturing outdoors, a Velcro 
strap is used to fasten the Wildlife 
Cam to a tree or fence post. The 
green acrylic case itself seems 
very tough and durable and snaps 
tightly shut, secured by two plastic 
clamps. Naturebytes has tested it 
in all weather conditions, and we 
experienced no leakage whatsoever 
following a downpour. On the 
front, a circle of clear plastic 
protects the Camera Module, 
while another translucent cover 
guards the PIR sensor. 


Start snapping 
Once in position, toggling the 
Powerboost switch turns on the 
camera and the picture-taking 
Python script will start running 
automatically. Our first attempt 
yielded a shot of a wood pigeon in 
flight, plus numerous photos of 
nothing: false positives triggered 
by the changing amount of sunlight. 
This effect can be reduced by 
repositioning the camera to avoid 
morning or afternoon glare, or by 
adjusting the sensitivity of the PIR. 
You can lure wildlife in front of 

the camera trap by placing it next 

to a bird table — we improvised by 
pouring some seeds onto an old 
garden table and managed to obtain 
a great shot of a magpie! There’s also 
an optional wooden arm to hang a 
bird-feeder in front of the camera. 


A camera 
that anyone 
can build to 
take stealthy 
high-definition 
images of 


wildlife 
Naturebytes 


Whatever tactic you use, 
viewing the photos at the end 
of the day is an exciting prospect, 


jus 


t to see what has been captured. 


While not ready at the time of 
writing, Naturebytes 


wo 


(wi 


lighting), or evenal 


an extra dimensi 


th a Pi NoIR came 


is also 


rking on an online community 
hub where users can share their 
wildlife photos, which should 
add 
project. Ideal for educational use, 
the Cam Kit is also quite versatile 
and could be used for 
photography, night-time shots 


on to the 


time-lapse 


ra and IR LED 


ive video feed. 


While more expensive than 
originally envisioned, the 
Wildlife Cam Kit is easy 
enough to assemble and fun 
to use. Once we'd sorted out 
the photo-taking delay issue, 

it worked well outdoors and 
the anticipation of seeing what 
it had captured was exciting. 


That lengthy battery recharge 
time is a little annoying, but it 
does power the unit for quite 
a while. Most importantly, the 
weatherproof case is very 
robust and may soon also be 
available as a standalone unit. 


x 


x 
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Maker 
says 


Read 


up to eight 


analogue 
inputs at 


once 
RasPiO 


AD/DA 
EXPANSION 
BOARD 


Based on the 
PCF8591T 8-bit 
ADC chip, it has 
four analogue 
inputs, WiringPi 
support, and 
can also do 
DAC conversion. 


£9 / $12 
magpi.cc/1syGYDs 
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RASPIO ANALOG ZERO 


RASPIO 
ANALO 


It makes the reading of analogue sensors as easy as Pi 


hile its mini form factor 

makes the Analog Zero 

a perfect partner for the 
Pi Zero, it’s a great way to add 
easy-to-use analogue inputs to 
any Raspberry Pi model. Supplied 
as a kit, it’s based around the 
MCP3008 analogue-to-digital 
converter (ADC) chip, but avoids 
all the intricate wiring usually 
required when using an ADC. 
The great thing about using this 
particular chip is that it’s already 
supported by the GPIO Zero Python 
library with its own class, so it’s a 
doddle to start writing programs 
to read and compare up to eight 
analogue inputs at once. Just use 
jumper wires to hook up your 
analogue sensors — temperature 
probes, light-dependent resistors, 
humidity sensors, gas detectors, 
potentiometers etc. — to any of the 
eight inputs in a female header, 
then write a few lines of code to 
get instant readings. Voltages 


up to 3.3V can 


be read directly; if 


the input is higher, you’ll need to 


use a voltage d 
resistors. Pote 


ivider made from 
ntial projects include 


a digital thermometer, voltmeter, 


and weather s 
all of these we 


tation, and kits for 
re offered as part 


of the Analog Zero’s successful 


seven-day Kic 
If you requir 


kstarter campaign. 
e greater accuracy 


than the MCP3008’s 10 bits, you 
always have the option of swapping 


it out for your 
ADC chip fore 


own 12-bit MCP3208 
xtra precision, since 


it fits the same socket and is also 
supported by GPIO Zero. Even so, 
the MCP3008’s 1,024 steps should 


be enough for 
Although th 


most projects. 
e Analog Zero makes 


things easier once assembled, 
note that you do have to doa 

bit of soldering beforehand, but 
everything’s well marked out 
on the board. As well as the chip 
socket, you’ll need to solder on 
the small female header for the 


analogue inputs, a couple of 
capacitors, a jumper switch, plus a 
40-way female header to connect 
to the Pi’s GPIO port. Handily, 
the board features through-holes 
for 25 GPIO pins, along witha 
mini 54-point prototyping area. 
There’s also the option to create 
a sleeker version by soldering 

the chip directly to the board and 
using surface-mount capacitors 
on the rear. 


{ast word 


We'd have appreciated a 
pre-assembled option, but 
once you've soldered the kit 
components onto the board, 
the Analog Zero really does 


make it much easier to use 
multiple analogue inputs for 
projects, particularly when 
using GPIO Zero. 
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-InIt¢ 3 


HISCORE= 
TITLE-INIT¢ 3 


-POATEC 3 


CAOOE==03 
TITLE_UPDATEC ) 
CAME_UPDATES ) 


CAODE!=1) 
f rur 


A fantasy 
console for 
making, 
sharing, 
and playing 
tiny games 
and other 
computer 


programs 
Lexaloffle 


PYGAME 


Pygame isa 
more powerful 
set of gaming 
modules that 
uses Python. 
It's not got the 
same holistic 
environment as 
PICO-8, though, 
but you can 
build some 
impressive 
games with it. 


pygame.org 
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PICO-&S 


Build, play, and share 8-bit games with this imaginary console 
with built-in code-, sprite-, and music-editing tools 


magine the best console 

from the 1980s that you 

never owned. As well as 
being able to play free games, you 
would be able to stop them at any 
time and dive backstage. 

You could tweak the code to 
make it easier, harder, or different. 
The built-in sprite editor and 
sound effects tools would let you 
customise the graphics. And there’d 
be a level editor for building new 
stages or changing existing ones. 

That’s PICO-8. It’s a virtual 
games console, but instead of 
being an actual 8-bit console, 
it recreates a virtual console with 
built-in editing tools. 

PICO-8 was developed by Joseph 
White from his base at Pico Pico 
Cafe in Kichijouji, Tokyo. It’s been 
around for Windows, Mac OS X, 
and Linux machines, but feels 
more naturally at home on the 
Raspberry Pi, where it can become 
the console it was meant to be. 


PICO-8 runs just fine on the 
Raspberry Pi hardware. We’d be 
surprised if it didn’t, because a 
key aspect is a deliberately limited 
feature set. The display is just 
128x128 blocks with 16 colours. 
Sprites are 8x8 pixels, and you can 
only have 128 on screen at once. 

The virtual cartridges (saved as 
PNG files) are limited to 32kB, and 
it has a four-channel sound chip. 

Imagine it sitting alongside 
a NES or PC Engine in terms 
of technical prowess. These 
deliberate limitations make 
PICO-8 more engaging. The games 
have a retro-cool aesthetic and 
they’ re easier to build. The low- 
spec nature of the console helps 
newcomers get started. 

Code is written in Lua. It’s a 
relatively simple language to learn 
and mostly used for scripting 
Adobe programs. While it’s no 
Python, Lua is worth learning. 
Games can be shared in a web 


browser, so you can see what 
sort of thing is possible on the 
Lexaloffle website. 


Community service 

A vibrant community has sprung 
up around PICO-8, with one of 
the most active fan bases we’ve 
seen. The forums are packed with 
interaction between developers, 
with everybody chipping in and 
offering to help. 

If there’s one downside, it’s that 
PICO-8 is a paid-for program. But 
we think it’s great value given the 
amount of fun we had, along with 
the active community. 


{ast word 


We had a huge amount of fun 
with PICO-8, and it's a natural 


fit for the Raspberry Pi. 
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RASPBERRY PI 
BESTSELLERS 


Combines a static type system and functional 
first design with a type-inferred object system. 


OCAML FROM 
THE VERY 
BEGINNING 


Author: John Whitington 
Publisher: Coherent Press 
Price: £24.99 

ISBN: 978-0957671102 
ocaml-book.com 


John Whitington’s introduction 
to OCaml as a modern general- 
purpose programming language 
will get any newbie up to speed, 
and its exercises will deepen 
your understanding. 


THINK 
OCAML 


Authors: Allen Downey and 
Nicholas Monje 

Publisher: Green Tea Press 
Price: Free download 
greenteapress.com 


OCaml as a first programming 
language? Yes, with this 
rewrite of Think Python 

(see last month), for functional 
programming. A free download 
that's well worth the time you'll 
need to invest. 


REALWORLD _- 
OCAML , 


Authors: Anil Madhavapeddy, 
Yaron Minsky and Jason Hickey 
Publisher: O'Reilly 

Price: £26.50 

ISBN: 978-1449323912 
oreilly/29UoLGY 


For confident beginners, or 
those with a little experience in 
OCaml or any other language, 
this is a deep dive into the 
possibilities of this functional 
programming language. 
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MAKE: FUN! 


Author: Bob Knetzger | Make: 


Publisher: Maker Media 
Price: £16.50 

ISBN: 978-1457194122 
oreil.ly/29UpdVL 


As the summer 
holidays stretch 
ahead, with the 
inevitable promise 
of rainy days and bored kids 
indoors, it’s time to turn to some 
quick and simple toy making. 
Independent toy inventor Bob 
Knetzger passes on his passion for 
making and inventing through a 
series of small projects to show 
just what’s possible when a little 
imagination is applied to a few 
everyday objects. 

Knetzger’s projects get you 
learning by making, giving 
the reader the skills and tools 
needed to finish a Raspberry Pi 
project’s casing and for physical 


LEARNING 
PYTHON FOR 
FORENSICS 


Author: Preston Miller 
and Chapin Bryce 
Publisher: Packt 
Price: £38.99 

ISBN: 978-1783285235 
magpi.cc/2Q9UoPX6 


Create, Your Quin 


Pronina 
Mawr Cragin fyes 


Continuing the theme 
of learning by doing, 
here’s an immersive coding 
experience for intermediate 
and not-quite-beginner Python 
programmers that teaches both 
forensic analysis and real-world 
Python scripting in tandem. Right 
from the opening Python intro, 
best practices for forensics are 
integrated into the learning. 
Python 2.7 is used, which is no 
longer satisfactory, and with the 
rise of Python 3 this is hopefully 
one of the last books to be written 
on Python 2. Nevertheless, even 
for relatively new learners, a 


Toys, 


Gunes, and Umrusements 
OR mes non-destructive modifications 


Learning P 
t 
for Forensic 


interactions. While some of 

the parts listed will take a little 
research for European readers 
to translate from American 
trade names and store 
references, almost everything 
is readily available, and no 

project here is beyond a keen 

beginner on a budget. 
Starting with kit-bashing and 


to existing toys, Knetzger ranges 
widely, taking in the mathematics 
of gnome hats and the myriad 
possibilities of polystyrene 
packaging foam. When a foundry 
is needed, or a strip heater to bend 
acrylic, Make: Fun! even shows you 
how to make these tools. From 
talking toys and 3D hacks, to edible 
lenses and a homemade yakitori 
grill, there’s something to inspire 
everyone’s imagination here. 


Score 


familiarity with Python 2 is 
still useful for working on, 
understanding, and re-factoring 
old code. You’ ll still want to 
supplement this book with 
one of the many Python 3 
books we’ve reviewed, and 
move your forensic scripts 
on where possible. 

After chapters on 
working with serialised 
data, and with databases for 
dealing with large quantities 
of data, a framework is 
created for parsing embedded 
metadata — useful programming 
skills for other fields - and this 
is returned to for building a full 
forensic framework in the final 
chapter. Rounded off by a useful 
appendix on troubleshooting 
exceptions, this look at an 
unfortunately all too necessary 
subject is a good way of developing 
Python skills, albeit Python 2. 


Score 
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EXPLORING 
RASPBERRY PI 


Author: Derek Molloy 
Publisher: Wiley 
Price: £23.99 

ISBN: 978-1119188681 
exploringrpi.com 


As the author notes 
in the introduction, 
the Pi’s integration of high-level 
Linux software with low-level 
electronics circuits represents 
a paradigm shift in embedded 
systems development. Molloy 
complements this statement with 
an introduction to embedded 
development for the Pi that takes 
in low-level hardware interfaces 
and high-level libraries, embracing 
every bus and interfacing option. 
The first section features 
hardware, software, and electronics 
tutorials to prime you with the 
basics you’ll need for the rest of the 
book, from using GitHub, through 


EXPERT F# 4.0 
FOUTH EDITION 


Authors: Don Syme, Adam 
Granicz and Antonio Cisternino 
Publisher: Apress 

Price: £41.50 

ISBN: 978-1484207413 
magpi.cc/29UpGXK 


F# 4.0 isa “mature, open- 
source, cross-platform, functional 
first programming language”; if 
you still think of Microsoft as the 
‘embrace and extend’ company 
driving everyone onto the Windows 
platform, it’s time to make a fresh 
assessment. Not only is F# all the 
things quoted and available on 
Raspbian (sudo apt-get install 
fsharp), it’s also a decent language, 
and well worth investigating if 
you’ve any work to get done on the 
Mono/.NET platform. 

Expert F# 4.0 gives you the 
wisdom of the language’s creator, 
Don Syme, aided by two maintainers 
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RASPBERRY py 


scripting language choice, to the 
role of pull-up resistors. Along the 
way you’ll read some great little 
intros to everything from 
how computers perform 
binary arithmetic, to 
crimping together custom 
cables for the GPIO, and 
plenty of useful tips to 
make your work easier. 
Weighing in at nearly 
700 pages, the bulk of the 
text is in the second and third 
parts, detailing interfacing the Pi 
to the physical environment and 
the internet, rounded off with a 


short intro to kernel programming. 


From adding extra UARTs, to 
writing C and C++ code for the Pi’s 
communication buses, Molloy’s 
succinct and useful examples 
ensure that this reference will 
spend as much time on your 
workshop desk as your bookshelf. 


Score 


of important F# projects, ina 
comprehensive introduction that 
embraces functional 
and imperative 
programming, working 
with data, and using the 
language’s strengths in 
diverse problem areas. 
Although F# is a fairly 
compact and expressive 
language, the authors’ 
emphasis on examples 
using popular libraries means the 
book’s 550 pages should be worked 
through with less skipping than 
occurs with some tutorials; the 
introduction emphasises where 
programmers from different 
backgrounds should put in the most 
effort, such as getting the hang 
of static types in early chapters if 
you’re a Python or Ruby coder. A 
little dry at times, but the best intro 
for .NET newbies. 


Score 


ESSENTIAL READING: 
COMMUNITY ESSENTIALS 


Running a hackspace, Raspberry Jam, or user 
group demands soft skills and hard organisation. 


Buzzing Communities 


Author: Richard Millington 
Publisher: FeverBee 
Price: £15.00 

ISBN: 978-0988359901 
feverbee.com 


Helps you create thriving online 
communities, with real-life examples, 
practical tips, and trusted community- 
building methods. 


The Art of Community 
Author: Jono Bacon 

Publisher: O'Reilly 

Price: £26.50 

ISBN: 978-1449312060 
oreil.ly/2aobuA4 


Comprehensive, open-source-focused 
guide to all aspects of community building 
from the Ubuntu community manager. 


User Group 
Leadership 


Author: Michelle Malcher 
Publisher: Apress 

Price: £14.50 

ISBN: 978-1484211168 
magpi.cc/2aobZue 


The essentials for those who have 
community leadership thrust upon them, 
or need to build a professional user group. 


Social by Social 


Author: Andy Gibson et al. 
Publisher: Nesta Lab 
Price: Free Download 
ISBN: 978-1906496418 
magpi.cc/2aobrog (PDF) 


SOCIAL BY SOCIAL 


Freely available guide to putting social 
technologies to use in community 
engagement, whose wisdom hasn't dated. 


| Hear You 


Author: Donny Ebenstein 
Publisher: Amacom 
Price: £18.99 

ISBN: 978-0814432198 
magpi.cc/2a0bZKF 


If it all goes wrong, skilled mediator and 
conflict negotiator Donny Ebenstein will 
get you back on track. 
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Community 


THE MONTH IN 
RASPBERRY PI 


Everything else that happened this month in the world of Raspberry Pi 


APOLLO 
MISSIONS 


ON 


THE 


RASPBERRY PI 


Right The Virtual 
AGC running on 
the Raspberry Pi: it 
barely takes up any 
processing power! 
It's designed to 
look like one of 

the original AGC 
control pads 


ou may have seen in the news recently that 
the full source code for the Apollo space 
missions has been published to GitHub 
(magpi.cc/2abpPcb). We understand that the code 
has been available in some form or another to the 
public for a few years now (NASA has a mandate to be 
open in everything it does, including making its code 
open source where possible); however, at the time of 
writing, this its first official presence on GitHub. 
What is the code actually for? Well, it’s the Apollo 
Guidance Computer (AGC) source code for the 
Command Module and Lunar Module of Apollo 11, 
for those not experts on the details of the Apollo 
missions, the Lunar Module was the moon lander, 


Gn Seine By one 0 #4 ye 


Apollo 15-17 Command Medute 
AGC simulation running! 
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Above The code for the Apollo missions all on paper, next to the 
director of software engineering at MIT, Margaret Hamilton. MIT 
was tasked with developing the software for Apollo 


which would detach from the Command Module when 
the craft got to the moon. The Command Module 
would then orbit the moon until the Lunar Module 
returned and redocked, then return to Earth. 


Building on Pi 

You may be wondering what this has to do with the 
Raspberry Pi? As you may be aware, the computers 
on the Apollo missions were not very sophisticated 
by today’s standards (they were similar to pocket 
calculators), so the Raspberry Pi should be more than 
capable of running the code. While still high on the 
success of the Astro Pi mission, Dave Honess of the 
Raspberry Pi Foundation found that Ron Burkey 
(github.com/rburkey2005) had already ported the code 
to Linux after its initial 2009 release and it was only a 
small step to get it going on the Raspberry Pi. 

“Tt takes about three minutes to build,” Dave told us 
as he proudly showed off the screenshot of the virtual 
AGC. This version not only runs Apollo 11’s code, but 
also Apollo 9, 13, 15, 16, and 17. Number 17 was the last 
Apollo mission. 

We’re hoping to bring you some articles about 
running the code on the Raspberry Pi in the next issue, 
giving you the chance to see how space technology 
worked in the Sixties and Seventies. 
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CROWDFUND 
THIS! 


The best crowdfunding hits this 
month for you to check out... 


RASPIO GPIO ZERO RULER 


The RasPiO GPIO rulers have been a great little addition 
to the collection of Raspberry Pi accessories for a while 
now. As well as being a genuine 30cm ruler, the original 
had a layout of the GPIO pins on a Raspberry Pi and some 
quick bits of information on Rpi.GPIO, the original way to 
program GPIO pins on the Pi. Now there’s a new version 
you can Kickstart that will have GPIO Zero functions on 
there instead. This is the very easy-to-use module for 
Python that allows you to simply connect components 

to the Pi, and now you can own a quick reference guide 
that also explains the GPIO pins to you. It’s already hit 
its target, so get in there and bag yourself one! 


ADVENTURE VENDING 
MACHINE 


| magpicc/zaav7Ps | 


This is the first Pi-powered art project we’ve come 
across on a crowdfunding site while writing this section, 
but we’re happy it exists. When funded, this vending 
machine will be set up at Burning Man 2016, and will 
dispense a quest for you to go on. Once you complete the 
quest, you’ ll get a coin which can be used to open a door 
and claim a prize. Apparently, it’s inspired by Leonardo 
da Vinci, and the creator’s aim is for it to inspire people 
to connect in meaningful ways. 
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THIS MONTH IN PI PQQ 


RASPBERRY SHAKE - 
SEISMOGRAPH 


We like this one: a seismograph add-on for your 
Raspberry Pi which allows you to detect seismic events 
(in other words: earthquakes). It’s sensitive enough to 
detect earthquakes of as little as magnitude 2 within 

a radius of 50 miles; if it’s a magnitude of 4 or higher, 
you can sense it from up to 300 miles away. Its maker 
says it will even be able to detect earthquakes further 
away, but you won’t get as much useful data. With the 
Raspberry Pi being used for more and more science 
experiments, we like the idea of a few geologists 
having one of these at home. 


BEST OF THE REST 


Here are some other great things we saw this month 


creator.matrix.one 


We're going to look at this more 
closely in a future issue, but this 
is an interesting development 
kit for the Raspberry Pi. It has 

a lot of different sensors and 
optimisations that make it great 
for studying places and taking 
good photos and video of them. 


farmbot.io R X . D) iz 


A Pi-powered robot which makes 
creating your own little vegetable 
farm a doddle thanks to superb 
components and code. It’s still in 
development and a little expensive, 
but it’s a really cool idea that may 
help out small communities. 


August 2016 MdgPi | 87 


Community 


WIMBLEDON 
RASPBERRY JAM: 


AN INTERVIEW WITH CAT LAMIN 


Practical tips for setting up a Raspberry Jam from 
educator and community cheerleader Cat Lamin 


he MagPi caught up with errors, and to let other teachers 

Cat Lamin after her recent know what they could do in their 

success at the Wimbledon classroom. | then came up with the 
Raspberry Jam to find out why idea of Coding Evenings as a way 
she loves the Raspberry Pi and to further allow sharing between 
Raspberry Jams. teachers and community members, 

which meant that lots of amazing 

How did you get involved with community people got involved.” 


the Raspberry Pi community? 
What was your first 


“As a teacher, various people Raspberry Jam? 

mentioned Raspberry Pi to me, 

including one of the techniciansin “I think the first actual Jam I 
school, but I wasn’t brave enough attended was the third birthday 
to get one. Eventually, the school party in Cambridge, when I 
bought me four to use with my accidentally volunteered to help 
Code Club and I sat them on a shelf out as a Jam maker, with no idea 
admiring them, but didn’t really what I was letting myself in for. 
know where to start untill went to Iwent to Egham Jam when Albert 
Picademy and had some training Hickey asked Carrie Anne Philbin 
in how to use one! My biggest to put out a plea for a teacher 
problem was understanding how to head over and do a talk about 
to set up the Pi and what to do if Picademy and using Pi in school. 
something went wrong. I’m now Pve been to Camjam, Egham Jam, 
an expert in debugging basic user Peterborough Jam, and the 4th 
errors; you’d be amazed at how birthday party, before organising 
many parents tell me that their my own Jam in Wimbledon with 
Raspberry Pi isn’t working until I help from Albert Hickey.” 


ask them to check the SD card is 

fully pushed in. How did organising that first Jam 
“I went to Picademy in July 2014. come about? 

While there, people were adding 


me on Twitter and Google+ and “Albert, who organises the Egham 
were chatting to me about projects Jam, approached me to see if I 

and ideas. I got really excited was interested in helping him run 
about the teaching possibilities the Jam in Wimbledon; he had 

of Pi, but was very aware of my been offered a venue and wanted 
own limitations. So I started a me to be involved from the start. 
blog to keep track of my many Wimbledon is close to the school 
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I teach in, and I knew this would 
be an excellent opportunity to give 
some of the children from school 
the opportunity to help develop 
their passions outside of school. 
What I really enjoyed about the 
Jam was seeing all of the families 
there, and several parents asked if 
we could let their children’s school 
know about the next one because 
they were keen to bring more 
families down! 

“T was really lucky with 
Wimbledon Jam as so many people 
offered their help almost straight 


CAT LAMIN - WIMBLEDON RASPBERRY JAM Community 


Ozzy and Jasper with their 
home-made Astro Pi 


server, and people seemed to enjoy 
the content. Workshops included 
Crumble Bot, CEEDuniverse and 
micro:Dbit, as well as Minecraft 

and Sense HAT. The workshops 
had varying numbers of signups, 
but all of them ended up being 
full because all of the children 
who attended were really keen 

to get involved and try things 
out. For show-and-tell we had 
Brian Corteil’s Micro PiNoon, 
Carl Monk’s Whack-A-Pi, and 
then Albert’s Pi-controlled crane. 
The children (and adults) had so 


I was really lucky with 
Wimbledon Jam as so many 
people offered their help 


away, and it was great having Ben 
[Nuttall] along as a representative 
from the Raspberry Pi Foundation: 
it added a sort of official stamp of 
approval to the day.” 


What’s your favourite thing about 
a Raspberry Jam? 


“I really like having workshops, 
talks, and show-and-tells going 
on and we were really lucky that 
loads of people were interested 

in doing everything. Our talks 
ranged from getting girls to code, 
to teaching, to using RPias a print 


raspberrypi.org/magpi 


much fun playing with the games, 
especially as Redfern and 4Tronix 
kindly donated prizes for some of 
them! One of my highlights from 
the day was watching the mums 
creep over to Whack-A-Pi and 
sneak a go while their children 
were taking part in workshops: 

it was very funny! 

“We had 80 people sign up to 
the Jam and around 60 turned up, 
including some ‘walk ins’. Twelve 
of the children attending the Jam 
were from my own school and 
there were probably another twelve 
who came with their parents.” 


Whack-A-Pi and its high scores 


SETTING UP 
YOUR OWN JAM: 


CAT'S TOP TIPS 


01. ATTEND ANOTHER JAM 

Attend a couple of Jams somewhere else to get 
a feel for them - Jams are all slightly different 
and you need to decide what you're interested 
in doing. 


03. ASK FOR SUPPORT 

Don't be afraid to ask for support from other 
community members and even businesses. In 
the past, I've found that a lot of the companies 
involved in selling Pi-based products are really 
keen to support events, and very generous with 
their donations of stickers and prizes. 
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RASPBERRY PI DAY 
AT HOPEWORKS 


RASPBERRY ~\’ 
JAM > iis \ ` 


Want to add your get-together? List it here: 


raspberrypi.org/jam/add 


THE FIRST TAUNTON 
RASPBERRY JAM 

When: Saturday 6 August 

Where: Taunton Library, 
Taunton, UK 
magpi.cc/2a8P41N 

Beginners and experts welcome 
at the first Taunton Jam, covering 
computing, robots, and more. 


EAGLE LABS 

RASPBERRY JAM 

When: Saturday 13 August 

Where: Innovation Birmingham 
Campus, Birmingham, UK 

magpi.cc/2a80PUo 

Raspberry Pi enthusiasts of all ages 

are welcome to explore show-and- 

tell projects and talks about the Pi. 
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RASPBERRY PI DAY 

AT HOPEWORKS 

When: Saturday 13 August 

Where: Camden Colab, Camden, 
NJ, USA 

magpi.cc/2a6XvaS 

Learn how to set up and use the 

Raspberry Pi thanks to mentors 

from around the region. 


SOUTHEND 

RASPBERRY JAM 10 

When: Saturday 20 August 

Where: Hive Enterprise Centre, 
Southend-on-Sea, UK 

magpi.cc/2a8Q3PD 

A Jam for those who are interested 

in Raspberry Pi, Astro Pi, Sonic Pi, 

Code Club, and much more! 


MINECRAFT 

PIBRARY JAM 

When: Thursday 25 August 

Where: Central Library, 
Coventry, UK 

magpi.cc/2a6XWI1S 

A Minecraft Library Jam where 

you’ll learn to code with Python 

and Java with Minecraft Pi. 


RASPBERRY JAM 

PRESTON 

When: Monday 5 September 

Where: Media Innovation Studio, 
Preston, UK 

magpi.cc/2a6XXG7 

Learn, create, and share the 

potential of the Raspberry Pi 

at a family-friendly event. 
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Pets pon, THE FIRST TAUNTON 
ater RASPBERRY JAM 


(aye EAGLE LABS 
°° RASPBERRY JAM 


RASPBERRY JAM LEEDS 
When: Wednesday 7 September 
Where: Swallow Hill Community 
College, Leeds, UK 
magpi.cc/2a6Yhoz 
Everyone is invited fora 
couple of hours of computing 
7 un, talks, demonstrations, 


and hands-on workshops. 


CAMJAM - CAMBRIDGE 

RASPBERRY JAM 

When: Saturday 17 September 

Where: Institute of Astronomy, 
Cambridge, UK 

magpi.cc/2a6Vr2W 

The famous CamJam is back this 

September, with plenty of people 

showing off projects and giving talks. 
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@ RASPBERRY JAM LEEDS 


SOUTHEND 
RASPBERRY JAM 10 


CAMJAM - CAMBRIDGE 
RASPBERRY JAM 


~~ - MINECRAFT 
5) PIBRARY JAM 


DONT 3 


MISS: CAMJAM 


When: Saturday 17 September Where: Institute of Astronomy, Cambridge, UK 


Tickets are now on sale for the insanely 
popular CamJam, the Raspberry Jam 
from the Raspberry Pi’s home town of 
Cambridge. The CamJam is back at the ——_ 
Institute of Astronomy and will have 
the usual selection of dealers’ tables, 
people with projects to show, wonderful 


workshops, and plenty of talks from Wr 
Leg 


excellent people within the Raspberry Pi —® 
community. Get your tickets fast before 
they sell out! You can find out more 
information on the event's page here: 


magpi.cc/2q06Vr2W 
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LETTERS 


A lot of 

people like the 
mission patches 
that came with 
issue 47 - send us 
your pictures of 
you wearing them! 


Astro Pi patch 

I loved issue 47 of The MagPi as I’ve been following 
along with Astro Pi very closely since the beginning. 
To see some of the results (especially the pictures 
from the hatch window!) was very exciting, and 

I’m glad to hear there will be more Astro Pi in some 
capacity in the future. 

I was also delighted to see the poster and patch 
with the issue. I’m trying to find a space to put the 
poster, which I can do, but I must confess I don’t 
actually know how to sew the patch on. Do you have 


any tips for a sewing beginner to attach it to my bag? 
Jake 


Thank you for your kind words about the feature, 
Jake. We’re really looking forward to covering more 
Astro Pi missions in the future. As for the patch, it’s 
actually quite simple! You can do it with just a sewing 
needle and some thread. 

We like to pin the patch in place so it stays in 
position; you can easily use a safety pin to do this. 
We also thread our needle by getting a length of 
thread and folding it in half; it then goes through 
the eye a little better, and you can tie it around 
the needle by just looping it over the point. No 
knots required! A few stitches around the edge is 
all you really need to do before tying it in place. 
There’s plenty of videos on YouTube (like this one: 
youtu.be/WzL1AEXAd7Y) that can help you out. 
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Being social 

I’m a recent convert to the Raspberry Pi and I buy 
the magazine from the shop every month. I’ve never 
really had the chance to get into computing, but I’m 
having a lot of fun learning! Who said you couldn’t 
teach an old dog new tricks? I’ve also recently 
started to get into social media; you don’t find many 
people in their seventies on Twitter, I bet! I was 
wondering where I can follow you online? 

Barry Harper 


We’re on several social channels around the web! On 
Twitter you can find us with the user name TheMagP1 
(twitter.com/TheMagP1), which is where we post a 
lot of updates about what’s going on with the mag and 
the Raspberry Pi community. We’re also on Facebook 
(facebook.com/MagPiMagazine) and Google+ 
(plus.google.com/+TheMagPi), if you prefer to use 
other forms of social media. We hope you enjoy the 
mag and get to learn much more! 
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YOUR LETTERS 


Community 


p 


FROM THE FORUM: 


The Raspberry Pi Forum is a hotbed of conversations and problem-solving for 
the community - join in via raspberrypi.org/forums 


bd 


LC THE 
PROBLEM 


n the article An Introduction to C, Simon 

Long presents a Hello World program in C. 

Unfortunately, Simon presents the main 
function with a return type of void, which as far as I 
know has never been the correct signature for main in 
any of the C standards. While a number of compilers 
will accept this code and produce the expected result, 
I think it would be better to have an introduction to 
C article that presents the signature of main that 
conforms to the standard. 


AndyD 


We asked Simon Long about it and he had this to say: 


One of Zero 
Since November of last year, I’ve picked up a few 
Raspberry Pi Zeros when I’ve noticed them on sale 
and needed more. I know they’re still quite popular, 
but I was wondering when the one Zero per person 
rule might start to be lifted? I have a project coming 
up that could definitely use a few Raspberry Pi Zeros 
if they were around! 

Regards, 
Terry P 


We’ve seen a few stores that have actually begun to 

lift their one Zero per customer rule, but it seems 

it’s not everywhere yet. The Raspberry Pi Zero is still 
selling out basically as fast as they can be made, so it’s 
a tricky thing to predict — it’s always been more up to 
the markets than anything else! As more stores lift the 
restriction, though, others will follow suit and by then 
the supply will probably be enough to meet demand. 
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“In the example in the first episode, I have shown 
a simplified prototype for main. For the record, in 25 
years of writing C professionally, I have yet to come 
across a compiler which considers main returning 
void to be an error, and for a lot of real-world C 
programming (embedded systems, standalone PC 
applications etc.), nothing is ever done with the 
returned value anyway. 

“Had I decided to show the strictly correct 
prototype for main in the first episode of an 
introduction to C, I would have had to explain what 
an int is, which would mean I would have had to 
explain variable types. I’d also have had to explain 
what an array of string pointers is (argv) and by the 
time I’d done that, I would a) have used up all the 
allotted words, and b) scared off every beginner who 
was reading it.” 

Apparently, there will be more on this in the 
future C tutorials in the magazine. We hope this 
clears up any problems! 


WRITE TO US 


Have you got something you'd like to say? 


Get in touch via magpi@raspberrypi.org or on The MagPi 
section of the forum at: raspberrypi.org/forums 
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Terms & Conditions 

Competition closes 25 August 2016. Prize is offered worldwide to participants aged 18 or over, except employees of the Raspberry Pi Foundation, the prize supplier, 
their families or friends. Winners will be notified by email after the draw date. By entering the competition, the winner consents to any publicity generated from the 

competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine (unless otherwise stated upon entry). We don't like 


spam. Participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. 
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Column | THE FINAL WORD 


THE 


MATT RICHARDSON 


Matt is Raspberry Pi’s US-based product evangelist. Before 
that, he was co-author of Getting Started with Raspberry Pi 
and a contributing editor at Make: magazine. 


‘UNSUNG 
í HERO 


Matt Richardson shares how software support 
is critical to Raspberry Pi’s success 


s Raspberry Pi enthusiasts, we tend to focus 
a lot on hardware. When a new or updated 
board is released, it garners a lot of attention 
and excitement. On one hand, that’s sensible because 
Raspberry Pi is a leader in pushing the boundaries 
of affordable hardware. On the other hand, it tends 
to overshadow the fact that strong software support 
makes an enormous contribution to Raspberry Pi’s 
success in education, hobby, and industrial markets. 
Because of that, I want to take the opportunity this 
month to highlight how important software is for 
Raspberry Pi. Whether you’re using our computer as a 
desktop replacement, a project platform, or a learning 
tool, you depend on an enormous amount of software 
built on top of the hardware. From the foundation of 
the Linux kernel, all the way up to the graphical user 
interface of the application you’ re using, you rely on 
the work of many people who have spent countless 
hours designing, developing, and testing software. 
The look and feel of the desktop environment in 
Raspbian serves as a good signal of the progress 
being made to the software made specifically for 
Raspberry Pi. I encourage you to compare the early 
versions of Raspbian’s desktop environment to 
what you get when you download Raspbian today. 
Many little tweaks are made with each release, and 
they’ve really built up to make a huge difference 
in the user experience. 


Skin deep 

And keep in mind that’s only considering the desktop 
interface of Raspbian. The improvements to the 
operating system under the hood go well beyond what 
you might notice on screen. For Raspberry Pi, there’s 
been updates for firmware, more functionality, and 
improved hardware drivers. All of this is in addition to 
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the ongoing improvements to the Linux kernel for all 
supported platforms. 

For those of us who are hobbyists, we have 
access to so many code libraries contributed by 
developers, so that we can create things easily with 
Raspberry Pi in a ton of different programming 
languages. As you probably know, the power of 
Raspberry Pi lies in its GPIO pins which make it 
perfect for physical computing projects, much like 
the ones you find in the pages of The MagPi. New 
Python libraries like GPIO Zero make it even easier 
than ever to explore physical computing. What 
used to take four lines of code is boiled down to just 
LED. blink(), for example. 

Not all software that helps us was made to run 
on Raspberry Pi directly. Take, for instance, Etcher, 

a wonderful program from the team at Resin. io. 
Etcher (etcher.io) is the easiest SD card flasher I have 
ever used, and takes a lot of guesswork out of flashing 
SD cards with Raspbian or any other operating system. 
Those of us who write tutorials are especially happy 
about this; since Etcher is cross-platform, you don’t 
need to have a separate set of instructions for people 
running Windows, Mac, and Linux. In addition, its 
well-designed graphical interface is a sight for sore 
eyes, especially for those of us who have been using 
command line tools for SD card flashing. 

The list of amazing software that supports 
Raspberry Pi could go on for pages, but I only have 
limited space here. So Pll leave you with my favourite 
point about Raspberry Pi’s strong software support. 
When you get a Raspberry Pi today and download 
Raspbian, you can rest assured that, because of the 
rapidly improving software support, it will only get 
better with age. You certainly can’t say that about 
everything you buy. 
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Raspberry Pi gets a home 
extension 


Endless expansion possibilities with Raspberry Pi 

The new RPI-BC enclosure is designed specifically to accommodate Raspberry Pi 
computers. The DIN rail or wall mountable enclosure provides access to all ports, 
GPIO pins and SD card without removing the lid. RPI-BC is part of the BC portfolio 
of electronics enclosures from Phoenix Contact. 


For additional information call 0845 881 2222 or visit phoenixcontact.co.uk/rpibc 
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LEARN TO CODE 
WITH SCRATCH 


Getstarted today for MAKE GAMES AND APPLICATIONS 


just £2.99 / $3.99 vo Raspberry Pi 


M The ® From the makers of the 
official Raspberry Pi magazine 


GET IT ON 


4 Available on the 


@ AppStore | | P> Google Play Find it on 
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The e 
l Tabs: Click the tabs 
to choose between 
ESSENTIALS changing a sprite's 


scripts, costumes, 
or sounds e——— 


The Blocks Palette: 
This is where you 
find the commands 
to control your 
sprites. Click the 
rounded buttons 


CHAPTER om 
GET STARTED | 


dragging blocks in from | costumes. Click the Stage inthe Sprite 4 and interact here 


LEARN TO 
FANH WITH 


Fancy yourself as Disney or Miyamoto? Whether your Gute imeane 


inspiration is Mickey Mouse or Mario, Scratch helps 
et things moving with Scratch! In a matter of minutes, you can 
build your first program to move the Scratch cat around the 


you to bring your creations to life. 
screen using the up, down, left, and right cursor keys. When 

you learn more later, you’ll bẹ able to develop this simple program into 
an art package with the cat aş the pen, a game (where should the cat 
go?), or anything else that needs keyboard-controlled movement. As 
you work through this chapter, you’ll learn how the Scratch screen is 
carved up, so yo sily find what you need as you build the other 
projects in this book. 

If you’re itching to write your own games or start building your own 


SCRATCH 


18 Raspberry Pi 
l 


[ KEEP UP 
TO DATE] 


Got the latest electronics projects, Scratch is the perfect place to start 
peas Its simplicity comes from the way you select commands from a m 
Wee eer | and join them together like jigsaw pieces. Because Scratch comes with 


Gide ee a collection of images and sounds, you can start making your first 
using: sudo apt- y 
program in minutes. 


get update && 
sudo apt-get +h’s power comes from the many creative ways in which you 
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magpi.cc/Scratch-book 
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Serial Pi Plus 


RS232 serial communication board. 
Control your Raspberry Pi over RS232 
or connect to external serial 
accessories. 


Breakout Pi Plus 


The Breakout Pi Plus is a useful 
and versatile prototyping expansion 
board for the Raspberry Pi 


ADC Differential Pi 


8 channel 18 bit analogue to digital 
converter. 1°C address selection 
allows you to add up to 32 analogue 
inputs to your Raspberry Pi. 


IO Pi Plus 


32 digital 5V inputs or outputs. I?C 
address selection allows you to stack 
up to 4 IO Pi Plus boards on your 
Raspberry Pi giving you 128 digital 
inputs or outputs. 


AIG Pi PIUS 


Real-time clock with battery backup 
and 5V I?C level converter for adding 
external 5V I?C devices to your 
Raspberry Pi. 


1 Wire Pi Plus 


1-Wire® to I?C host interface with ESD 
protection diode and |?C address 
selection. 
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Now 
Available 
for the 
Pi Zero 


SAVE 


15% 


“MagPi15” 


discount code 


GoPiGo 


Everything you need to 
build a Raspberry Pi robot! 
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